> ## Documentation Index
> Fetch the complete documentation index at: https://developers.phrase.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Phrase MCP Server

> Connect any Model Context Protocol (MCP)-compatible AI tool to Phrase.

The Phrase MCP Server lets an AI assistant work directly with your Phrase data. It can check job status, run quality checks, or start routine work in plain language, without opening Phrase or writing code. Any Phrase account with API access can use it.

## Connect

No installation, no tokens to manage. You sign in with your existing Phrase account.

**Prerequisites**

* An active Phrase account with access to the organization you want to connect
* An MCP-compatible AI tool that supports adding a remote server by URL

<Steps>
  <Step title="Register the server">
    Point your MCP client at the server URL for your region:

    * EU: `https://mcp.eu.phrase.com`
    * US: `https://mcp.us.phrase.com`

    Check your Phrase account URL (`eu.phrase.com` or `us.phrase.com`) if you're not sure which region you're on. Exactly how you register a remote server depends on your client. Refer to its documentation for the precise steps.

    <Tabs>
      <Tab title="Claude Code">
        ```bash theme={null}
        claude mcp add --transport streamable-http phrase-mcp-prod-eu https://mcp.eu.phrase.com
        ```

        Use `phrase-mcp-prod-us` and the US URL if that's your region.
      </Tab>

      <Tab title="ChatGPT">
        1. Go to **Settings → Connectors → Advanced settings → Add custom connector**.
        2. Name it `Phrase`, paste the server URL for your region, and leave authentication as-is, you'll sign in in the next step.
        3. Save the connector.
      </Tab>
    </Tabs>
  </Step>

  <Step title="Authorize">
    Start the authorization flow from your client. Sign in, pick your organization, and choose what to allow: View data, Create data, or Modify and delete data. Your normal Phrase role permissions still apply. This only restricts what you can do, it never expands it. You can change this later.

    <Tabs>
      <Tab title="Claude Code">
        Run `/mcp` and select the Phrase server.
      </Tab>

      <Tab title="ChatGPT">
        Open the Phrase connector and click **Connect**.
      </Tab>
    </Tabs>
  </Step>

  <Step title="Confirm it's connected">
    Ask your assistant to "fetch my most recent Phrase project."
  </Step>
</Steps>

You can view what you've authorized and revoke access anytime from your Phrase profile settings, under the Consents tab. This list is scoped to whichever organization you're signed into. If you connect to more than one organization, check each one separately. To see or manage consents for a different organization, sign out and back in under that organization first.

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="&#x22;Authentication failed&#x22; after signing in">
    The sign-in didn't complete. Restart the authorization flow from your client and try again.
  </Accordion>

  <Accordion title="Nothing happens when you ask a question">
    Confirm the server shows as connected in your client.
  </Accordion>

  <Accordion title="Permission errors">
    The scopes you granted at authorization limit what the assistant can do. Your Phrase role permissions still apply in addition to them, not instead of them. Check what you allowed when you connected.
  </Accordion>
</AccordionGroup>

## What's next

Once you're connected, head to **[Starter prompts](/en/mcp-server-starter-prompts)** to see what to try first.

***

## Local install (legacy)

Before the hosted server above, the Phrase MCP Server was a self-hosted, open-source package you ran yourself with your own API tokens. It's still available for teams already using it, but the connect flow above is now the recommended way to get started.

Setup, configuration, and troubleshooting for the local install live in the [phrase/phrase-mcp-server](https://github.com/phrase/phrase-mcp-server) README.