Skip to main content
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
1

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.
Use phrase-mcp-prod-us and the US URL if that’s your region.
2

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.
Run /mcp and select the Phrase server.
3

Confirm it's connected

Ask your assistant to “fetch my most recent Phrase project.”
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

The sign-in didn’t complete. Restart the authorization flow from your client and try again.
Confirm the server shows as connected in your client.
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.

​
What’s next

Once you’re connected, head to 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 README.