Monday, August 17, 2026·3 min read
Connecting the TextUnited MCP server to your favorite AI tools

TextUnited MCP supports two authentication methods: API key and OAuth. OAuth lets you sign in to TextUnited and authorize access during setup. With an API key, you provide a scoped bearer token. The setup steps vary by AI tool; ChatGPT web supports custom MCP connections on eligible plans, with available actions depending on plan, workspace settings, and TextUnited permissions.
Here's how to get set up with an API key.
1. Generate a Personal Access Token
Before you configure anything on the application side, you need a token from the TextUnited portal to handle authentication.
Head to Account Settings → Security & access → API tokens → Create token.
When creating the token, you’ll be asked to define its scope. The scope controls what the token is allowed to do. For the MCP server to work, select both the Assets and Projects scopes:
Assets
- assets: read
- assets: write
Projects
- projects: read
- projects: write
Copy and save the token right after it's generated. TextUnited stores only a hash of the token, not the token itself, so once you close that screen you cannot retrieve it again.
2. Configure the Connection
The exact setup screen differs from app to app, but the underlying connection details are always the same:
- Server URL: https://mcp.textunited.com/mcp
- Transport Type: HTTP (this tells the application the server is remote, not running locally)
- Authorization: Bearer token, passed as an HTTP header:
3. Application-Specific Setup
- UI-based tools (e.g., Codex/ChatGPT app): Go to Settings, find the "Plugins and MCP servers" section, add a new server, and enter the URL along with the authorization header.
Example, as in Codex
- CLI-based tools (e.g., Claude Code): Run one command with the transport (http), a name for the connection, the server address, and your bearer token:
claude mcp add --transport http textunited \
https://mcp.textunited.com/mcp \
--header "Authorization: Bearer <your_token>"In Cursor, and in most tools that use a JSON config file, the same values look like this in your MCP config file (for Cursor: ~/.cursor/mcp.json for all projects, or .cursor/mcp.json inside a single project):
{
"mcpServers": {
"textunited": {
"url": "https://mcp.textunited.com/mcp",
"headers": {
"Authorization": "Bearer <your_token>"
}
}
}
}Check your application's own documentation for the exact field names or command syntax, since these vary by tool.
4. Verify the Connection
After you save your configuration, restart the application. It can take one to seven minutes for the app to recognize the TextUnited MCP server as active.
To confirm the connection and the token, ask your AI assistant to look up a term in your terminology or to list your assets. The server answers general questions about countries and languages without a token, so "yes, I can see the server" alone does not prove your token works.
Once connected, your AI assistant can tap into TextUnited's terminology directly inside your everyday tools. No more switching tabs to check a term or update your glossary.
Frequently asked questions
Learn more about connecting TextUnited's MCP server to AI tools.
Related Posts

How to use TextUnited API: Instant translation & project creation


One English word names six unrelated ideas. The Concepts editor keeps them apart.

