From acf837245599b8cc17a6640964bb985bb45b157d Mon Sep 17 00:00:00 2001 From: Andrii Bodnar Date: Wed, 4 Mar 2026 10:39:32 +0200 Subject: [PATCH 1/2] docs: move Crowdin MCP to Developer Portal --- .../api}/crowdin-mcp-server.mdx | 223 +++++++++++------ src/content/docs/developer/api/overview.mdx | 17 ++ .../crowdin-mcp-server.mdx | 231 ------------------ src/content/sidebars/developer.ts | 1 + vercel.json | 5 +- 5 files changed, 171 insertions(+), 306 deletions(-) rename src/content/docs/{crowdin/translation-process => developer/api}/crowdin-mcp-server.mdx (58%) delete mode 100644 src/content/docs/enterprise/translation-process/crowdin-mcp-server.mdx diff --git a/src/content/docs/crowdin/translation-process/crowdin-mcp-server.mdx b/src/content/docs/developer/api/crowdin-mcp-server.mdx similarity index 58% rename from src/content/docs/crowdin/translation-process/crowdin-mcp-server.mdx rename to src/content/docs/developer/api/crowdin-mcp-server.mdx index 0831a95e..91ed926a 100644 --- a/src/content/docs/crowdin/translation-process/crowdin-mcp-server.mdx +++ b/src/content/docs/developer/api/crowdin-mcp-server.mdx @@ -1,12 +1,10 @@ --- title: Crowdin MCP Server description: Manage your Crowdin projects using natural-language AI commands. -slug: crowdin-mcp-server -sidebar: - order: 2 +slug: developer/crowdin-mcp-server --- -import { Steps, Aside } from '@astrojs/starlight/components'; +import { Steps, Aside, Tabs, TabItem } from '@astrojs/starlight/components'; import { Icon } from 'astro-icon/components'; import ReadMore from '~/components/ReadMore.astro'; @@ -35,18 +33,26 @@ This section provides the details needed to connect your AI client to Crowdin. To connect to your Crowdin account, the MCP Server uses a **Personal Access Token (PAT)**. This token is your secure key. When you create a token, you must grant it specific **scopes** (permissions) that define what actions it can perform. For the MCP Server to function correctly, the token you use must have the necessary scopes for the commands you want to give. For example, to create a project task, your token will need the **Tasks (Read and Write)** scope. - Read more about [Creating a Personal Access Token](/account-settings/#creating-a-personal-access-token). + Read more about [Creating a Personal Access Token (Crowdin)](/account-settings/#creating-a-personal-access-token) or [Creating a Personal Access Token (Crowdin Enterprise)](/enterprise/account-settings/#creating-a-personal-access-token). ### Endpoint Structure -Construct the URL based on your role in the project and the tool set you wish to use. +Construct the URL based on your role in the project (Crowdin) or organization or project (Crowdin Enterprise) and the tool set you wish to use. + +Crowdin MCP endpoint: ``` https://mcp.crowdin.com/mcp/{tool-set} ``` -Replace `{tool-set}` with a role from the table below. +Crowdin Enterprise MCP endpoint: + +``` +https://{your-organization-domain}.mcp.crowdin.com/mcp/{tool-set} +``` + +Replace `{tool-set}` with a role from the table below. For Crowdin Enterprise, replace `{your-organization-domain}` with your organization's unique name. ### Available Tool Sets @@ -54,6 +60,7 @@ Replace `{tool-set}` with a role from the table below. * **`developer`** - Source files, builds, and integrations. * **`translator`** - Translation and linguistic tools. * **`asset-manager`** - Glossaries and translation memory. +* **`admin`** - User management and organization configuration. **(Crowdin Enterprise only.)**