Skip to content

Commit 0328171

Browse files
theAPILifeclaude
andauthored
Add DeepL MCP Server docs to Developer Tools (#267)
* 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) <noreply@anthropic.com> * 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) <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent 727308f commit 0328171

2 files changed

Lines changed: 121 additions & 1 deletion

File tree

docs.json

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -45,7 +45,8 @@
4545
"group": "Developer Tools",
4646
"pages": [
4747
"docs/getting-started/client-libraries",
48-
"docs/getting-started/deepl-cli"
48+
"docs/getting-started/deepl-cli",
49+
"docs/getting-started/deepl-mcp-server"
4950
]
5051
},
5152
"docs/getting-started/managing-api-keys",
Lines changed: 119 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,119 @@
1+
---
2+
title: "DeepL MCP Server"
3+
description: "Use the DeepL MCP Server to add translation capabilities to Claude, Cursor, and other AI agents."
4+
public: true
5+
---
6+
7+
**This page shows you:**
8+
- What the DeepL MCP Server does and when to use it
9+
- How to install and configure it for Claude Code and Claude Desktop
10+
- What tools are available to your AI agent
11+
12+
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.
13+
14+
<Note>
15+
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).
16+
</Note>
17+
18+
## Prerequisites
19+
20+
- [Node.js](https://nodejs.org/) v18 or later
21+
- A DeepL API key ([create a free account](https://www.deepl.com/en/pro/change-plan#developer))
22+
23+
## Quick start
24+
25+
Run the server directly with npx:
26+
27+
```bash
28+
npx deepl-mcp-server
29+
```
30+
31+
Or install it locally:
32+
33+
```bash
34+
npm install deepl-mcp-server
35+
```
36+
37+
## Configuration
38+
39+
<Tabs>
40+
<Tab title="Claude Code">
41+
42+
Add the MCP server to Claude Code with a single command:
43+
44+
```bash
45+
claude mcp add deepl -e DEEPL_API_KEY=your-api-key -- npx deepl-mcp-server
46+
```
47+
48+
Claude Code will now have access to DeepL translation tools in every session.
49+
50+
</Tab>
51+
<Tab title="Claude Desktop">
52+
53+
Add the following to your Claude Desktop configuration file:
54+
55+
- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
56+
- **Windows**: `%AppData%\Claude\claude_desktop_config.json`
57+
- **Linux**: `~/.config/Claude/claude_desktop_config.json`
58+
59+
```json
60+
{
61+
"mcpServers": {
62+
"deepl": {
63+
"command": "npx",
64+
"args": ["deepl-mcp-server"],
65+
"env": {
66+
"DEEPL_API_KEY": "your-api-key"
67+
}
68+
}
69+
}
70+
}
71+
```
72+
73+
Restart Claude Desktop to activate the server.
74+
75+
</Tab>
76+
<Tab title="Other MCP clients">
77+
78+
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.
79+
80+
Refer to your client's documentation for how to add MCP servers.
81+
82+
</Tab>
83+
</Tabs>
84+
85+
## Available tools
86+
87+
Once configured, your AI agent can use the following tools:
88+
89+
| **Tool** | **Description** |
90+
|----------|-----------------|
91+
| `translate-text` | Translate text between languages with automatic source language detection |
92+
| `translate-document` | Translate documents (PDF, DOCX, PPTX, XLSX, HTML, TXT) with format preservation |
93+
| `rephrase-text` | Improve and rephrase text with customizable writing style and tone |
94+
| `get-source-languages` | List all available source languages |
95+
| `get-target-languages` | List all available target languages |
96+
| `get-glossary-info` | Retrieve details about a specific glossary |
97+
| `get-glossary-entries` | Fetch dictionary entries from a glossary |
98+
| `list-glossaries` | List all glossaries in your account |
99+
100+
## Example usage
101+
102+
Once the MCP server is connected, you can ask your AI agent things like:
103+
104+
- "Translate this email into German with formal tone"
105+
- "Translate my report.pdf into French"
106+
- "Rephrase this paragraph to sound more professional"
107+
- "What languages does DeepL support?"
108+
- "Show me the entries in my marketing glossary"
109+
110+
The agent will automatically use the appropriate DeepL tool to fulfill the request.
111+
112+
## Next steps
113+
114+
Now that you know how to use the DeepL MCP Server:
115+
116+
- **Explore the source:** Review the [DeepL MCP Server on GitHub](https://github.com/DeepLcom/deepl-mcp-server) for full documentation and source code
117+
- **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
118+
- **Set up authentication:** Learn about [DeepL API authentication](/docs/getting-started/auth) and key management
119+
- **Use client libraries:** Explore the [official SDKs](/docs/getting-started/client-libraries) for Python, Node.js, and more

0 commit comments

Comments
 (0)