From 6390bfaafe9c97ba65a16668a9e0a8cdeb2bfbbb Mon Sep 17 00:00:00 2001 From: Ming Gong Date: Mon, 16 Mar 2026 11:29:34 -0400 Subject: [PATCH 1/2] Add DeepL MCP Server documentation to Developer Tools Adds a user-facing guide for the pre-built deepl-mcp-server package, covering installation, configuration for Claude Code/Desktop, and the 8 available tools. This complements the existing MCP cookbook (which teaches building a custom server from scratch). Also creates the Developer Tools navigation group under Getting Started, moving client-libraries into it alongside the new MCP server page. Co-Authored-By: Claude Opus 4.6 (1M context) --- docs.json | 3 +- docs/getting-started/deepl-mcp-server.mdx | 117 ++++++++++++++++++++++ 2 files changed, 119 insertions(+), 1 deletion(-) create mode 100644 docs/getting-started/deepl-mcp-server.mdx diff --git a/docs.json b/docs.json index b2b0def..ff0c5d0 100644 --- a/docs.json +++ b/docs.json @@ -45,7 +45,8 @@ "group": "Developer Tools", "pages": [ "docs/getting-started/client-libraries", - "docs/getting-started/deepl-cli" + "docs/getting-started/deepl-cli", + "docs/getting-started/deepl-mcp-server" ] }, "docs/getting-started/managing-api-keys", diff --git a/docs/getting-started/deepl-mcp-server.mdx b/docs/getting-started/deepl-mcp-server.mdx new file mode 100644 index 0000000..1cd0135 --- /dev/null +++ b/docs/getting-started/deepl-mcp-server.mdx @@ -0,0 +1,117 @@ +--- +title: "DeepL MCP Server" +description: "Use the DeepL MCP Server to add translation capabilities to Claude, Cursor, and other AI agents." +public: true +--- + +**This page shows you:** +- What the DeepL MCP Server does and when to use it +- How to install and configure it for Claude Code and Claude Desktop +- What tools are available to your AI agent + +The [DeepL MCP Server](https://github.com/DeepLcom/deepl-mcp-server) is an open-source (MIT license) [Model Context Protocol](https://modelcontextprotocol.io/) server that gives AI agents access to DeepL's translation, text improvement, and glossary capabilities. + + +If you want to build a custom MCP server from scratch using the DeepL API, see the [MCP Server Cookbook](/docs/learning-how-tos/examples-and-guides/deepl-mcp-server-how-to-build-and-use-translation-in-llm-applications). + + +## Prerequisites + +- [Node.js](https://nodejs.org/) v18 or later +- A DeepL API key ([create a free account](https://www.deepl.com/en/pro/change-plan#developer)) + +## Quick start + +Run the server directly with npx: + +```bash +npx deepl-mcp-server +``` + +Or install it locally: + +```bash +npm install deepl-mcp-server +``` + +## Configuration + + + + +Add the MCP server to Claude Code with a single command: + +```bash +claude mcp add deepl -e DEEPL_API_KEY=your-api-key -- npx deepl-mcp-server +``` + +Claude Code will now have access to DeepL translation tools in every session. + + + + +Add the following to your Claude Desktop configuration file: + +- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json` +- **Windows**: `%AppData%\Claude\claude_desktop_config.json` +- **Linux**: `~/.config/Claude/claude_desktop_config.json` + +```json +{ + "mcpServers": { + "deepl": { + "command": "npx", + "args": ["deepl-mcp-server"], + "env": { + "DEEPL_API_KEY": "your-api-key" + } + } + } +} +``` + +Restart Claude Desktop to activate the server. + + + + +The DeepL MCP Server works with any MCP-compatible client. Configure it using the `npx deepl-mcp-server` command and pass your API key via the `DEEPL_API_KEY` environment variable. + +Refer to your client's documentation for how to add MCP servers. + + + + +## Available tools + +Once configured, your AI agent can use the following tools: + +| Tool | Description | +|------|-------------| +| `translate-text` | Translate text between languages with automatic source language detection | +| `translate-document` | Translate documents (PDF, DOCX, PPTX, XLSX, HTML, TXT) with format preservation | +| `rephrase-text` | Improve and rephrase text with customizable writing style and tone | +| `get-source-languages` | List all available source languages | +| `get-target-languages` | List all available target languages | +| `get-glossary-info` | Retrieve details about a specific glossary | +| `get-glossary-entries` | Fetch dictionary entries from a glossary | +| `list-glossaries` | List all glossaries in your account | + +## Example usage + +Once the MCP server is connected, you can ask your AI agent things like: + +- "Translate this email into German with formal tone" +- "Translate my report.pdf into French" +- "Rephrase this paragraph to sound more professional" +- "What languages does DeepL support?" +- "Show me the entries in my marketing glossary" + +The agent will automatically use the appropriate DeepL tool to fulfill the request. + +## Further reading + +- [DeepL MCP Server on GitHub](https://github.com/DeepLcom/deepl-mcp-server) — full documentation, issues, and source code +- [MCP Server Cookbook](/docs/learning-how-tos/examples-and-guides/deepl-mcp-server-how-to-build-and-use-translation-in-llm-applications) — build a custom MCP server from scratch +- [DeepL API authentication](/docs/getting-started/auth) — set up your API key +- [Client libraries](/docs/getting-started/client-libraries) — official SDKs for Python, Node.js, and more From 8142fc48181a6d3b6e347310fd557a86b6166b5b Mon Sep 17 00:00:00 2001 From: Ming Gong Date: Mon, 16 Mar 2026 11:41:12 -0400 Subject: [PATCH 2/2] Apply docs-reviewer feedback to MCP server page - Bold table headers for consistency with other docs - Rename "Further reading" to "Next steps" with action-oriented lead-ins - Add brief MCP explanation sentence for first-time readers Co-Authored-By: Claude Opus 4.6 (1M context) --- docs/getting-started/deepl-mcp-server.mdx | 18 ++++++++++-------- 1 file changed, 10 insertions(+), 8 deletions(-) diff --git a/docs/getting-started/deepl-mcp-server.mdx b/docs/getting-started/deepl-mcp-server.mdx index 1cd0135..d5570cc 100644 --- a/docs/getting-started/deepl-mcp-server.mdx +++ b/docs/getting-started/deepl-mcp-server.mdx @@ -9,7 +9,7 @@ public: true - How to install and configure it for Claude Code and Claude Desktop - What tools are available to your AI agent -The [DeepL MCP Server](https://github.com/DeepLcom/deepl-mcp-server) is an open-source (MIT license) [Model Context Protocol](https://modelcontextprotocol.io/) server that gives AI agents access to DeepL's translation, text improvement, and glossary capabilities. +The [DeepL MCP Server](https://github.com/DeepLcom/deepl-mcp-server) is an open-source (MIT license) [Model Context Protocol](https://modelcontextprotocol.io/) server that gives AI agents access to DeepL's translation, text improvement, and glossary capabilities. MCP lets AI agents discover and call external tools through a standardized protocol — your agent sends a tool request to the MCP server, which calls the DeepL API and returns the result. If you want to build a custom MCP server from scratch using the DeepL API, see the [MCP Server Cookbook](/docs/learning-how-tos/examples-and-guides/deepl-mcp-server-how-to-build-and-use-translation-in-llm-applications). @@ -86,8 +86,8 @@ Refer to your client's documentation for how to add MCP servers. Once configured, your AI agent can use the following tools: -| Tool | Description | -|------|-------------| +| **Tool** | **Description** | +|----------|-----------------| | `translate-text` | Translate text between languages with automatic source language detection | | `translate-document` | Translate documents (PDF, DOCX, PPTX, XLSX, HTML, TXT) with format preservation | | `rephrase-text` | Improve and rephrase text with customizable writing style and tone | @@ -109,9 +109,11 @@ Once the MCP server is connected, you can ask your AI agent things like: The agent will automatically use the appropriate DeepL tool to fulfill the request. -## Further reading +## Next steps -- [DeepL MCP Server on GitHub](https://github.com/DeepLcom/deepl-mcp-server) — full documentation, issues, and source code -- [MCP Server Cookbook](/docs/learning-how-tos/examples-and-guides/deepl-mcp-server-how-to-build-and-use-translation-in-llm-applications) — build a custom MCP server from scratch -- [DeepL API authentication](/docs/getting-started/auth) — set up your API key -- [Client libraries](/docs/getting-started/client-libraries) — official SDKs for Python, Node.js, and more +Now that you know how to use the DeepL MCP Server: + +- **Explore the source:** Review the [DeepL MCP Server on GitHub](https://github.com/DeepLcom/deepl-mcp-server) for full documentation and source code +- **Build your own:** Follow the [MCP Server Cookbook](/docs/learning-how-tos/examples-and-guides/deepl-mcp-server-how-to-build-and-use-translation-in-llm-applications) to create a custom MCP server from scratch +- **Set up authentication:** Learn about [DeepL API authentication](/docs/getting-started/auth) and key management +- **Use client libraries:** Explore the [official SDKs](/docs/getting-started/client-libraries) for Python, Node.js, and more