3行でいうと

  • Docs MCP Server(https://developers.deepl.com/mcp)は、翻訳をせず、開発者向けドキュメントを検索して読むだけの読み取り専用です。APIキーも認証も要りません。Claude Code、Claude Desktop、Cursor、VS Codeへの設定が、公式のページに載っています。
  • プログラムから使うなら、APIキーを Authorization: DeepL-Auth-Key ... ヘッダーで送ります。Proのプランの呼び出し先は https://api.deepl.com、無料は https://api-free.deepl.com です。キーはこの記事ではすべてプレースホルダです。
  • 公式のPythonライブラリは pip install --upgrade deepl、DeepL CLIは(ページの記載では)ソースから入れます。環境変数の名前が、ライブラリのCLI(DEEPL_AUTH_KEY)とDeepL CLI(DEEPL_API_KEY)で違います。
  • CATツールには、認証キーを使います。対象のプランと、キーの場所が、ヘルプに書かれています。APIの記事とキーの場所のURLが違う書き方なので、併記します。
  • 「外し方」は、公式に書かれている範囲が狭いです。APIキーを消す・作り直す画面、CATのキーの取り消しは、読んだページに記載が見つかりません。

この記事は、公式の資料を2026年10月25日に読んでまとめたものです。この記事は、実際に使って確かめた記録ではありません。手順は、公式の手順を順に並べたものです。設定例は、「公式の例の写し」か、「公式の記載に合わせて、この記事で組んだ例(動作は確かめていません)」と、そのつど書き分けます。画面の表記は変わるので、手元の画面と照らしてください。公式ページは要約の形で取得したため、読めていない部分は「公式で確認できていない」と書いています。

先に結論

前提:用語をそろえる

連携1:Docs MCP Server(AIコーディングツールにDeepLの開発者向けドキュメントを読ませる)

何か

開発者向けドキュメントの検索と閲覧だけをするMCPサーバーです。翻訳はしません。URLは https://developers.deepl.com/mcp で、APIキーも認証も要りません。機能は、キーワードでページを探して題名・断片・リンクを返す「検索」と、ページ全文を開く「読む」の2つです(正式なツール名は、ページに書かれていません)。

設定(公式のページの例の写し)

claude mcp add --transport http deepl-docs https://developers.deepl.com/mcp
{
  "mcpServers": {
    "deepl-docs": {
      "url": "https://developers.deepl.com/mcp"
    }
  }
}
{
  "servers": {
    "deepl-docs": {
      "type": "http",
      "url": "https://developers.deepl.com/mcp"
    }
  }
}

渡るデータ、権限、外し方

連携2:API(自分のプログラムからDeepLを呼ぶ)

2-1 アカウントとキー(開発者向けドキュメント「Quickstart」)

  1. DeepLのプランのページ(deepl.com/pro-api の料金の欄)で、プランを選んで登録します。すでにDeepL Translatorのアカウントがあっても、APIには新しいアカウントが必要です。クイックスタートは、いまのアカウントからログアウトして、新しく作る、と書き、サポートの記事へのリンクを付けています。
  2. キーは、deepl.com/your-account/keys に載っています。メニューの経路は、書かれていません。
  3. 呼び出す先は、Proのプランが https://api.deepl.com、無料のプランが https://api-free.deepl.com です。

2-2 最初のリクエスト(公式の例の写し。キーの値はプレースホルダ)

POST /v2/translate HTTP/2
Host: api.deepl.com
Authorization: DeepL-Auth-Key [yourAuthKey]
User-Agent: YourApp/1.2.3
Content-Length: 45
Content-Type: application/json

{"text":["Hello, world!"],"target_lang":"DE"}

返ってくる例は、次のとおりです。

{
  "translations": [
    {
      "detected_source_language": "EN",
      "text": "Hallo, Welt!"
    }
  ]
}

2-3 公式のPythonライブラリ(GitHubのREADME)

  1. インストール:
pip install --upgrade deepl
  1. 動作条件:READMEは、Python 3.9から3.13でテストされている、requests のモジュール(2.32.4以上)が必要、と書いています。ライセンスはMITです。
  2. 最初の例(READMEの例の写し。キーの値はプレースホルダに替えました):
import deepl

auth_key = "YOUR_API_KEY"  # Replace with your key
deepl_client = deepl.DeepLClient(auth_key)

result = deepl_client.translate_text("Hello, world!", target_lang="FR")
print(result.text)  # "Bonjour, le monde !"

2-4 DeepL CLI(開発者向けドキュメント「DeepL CLI」)

オープンソース(MITライセンス)のコマンドラインツールです。ページには、npmのパッケージとして公開されているとは書かれていません。ソースから入れます。

git clone https://github.com/DeepL/deepl-cli.git
cd deepl-cli
npm install
npm run build
npm link

deepl --version
deepl translate "Hello, world!" --to es
deepl document translate report.pdf --to fr --output report-fr.pdf

2-5 キーの外し方・守り方

連携3:CATツール(memoQ、Trados Studio、Phrase TMS)

ヘルプ「Use authentication key for CAT tools」の内容です。

渡るデータのまとめ

連携 文章の流れ 公式の記載 書かれていないこと
Docs MCP Server AIが検索する言葉 → DeepLのドキュメントのサーバー 読み取り専用。翻訳の文章は送らない ログ、保持
API、Pythonライブラリ、CLI 自分のプログラム → DeepL(api.deepl.com、無料は api-free.deepl.com) データの扱いは、プランで違う(04) 無料のAPIと有料のAPIの区別は、04を参照
CATツール CATツールのプラグイン → DeepL 記事には書かれていない データの保持と学習への扱い

つまずきと確認点

つまずき 公式の記載に沿った確認点
APIが403を返す 認証方式の変更(キーは DeepL-Auth-Key ヘッダーで送る)。地域のエンドポイント(api-us.deepl.com、api-jp.deepl.com)は、追加契約をした顧客だけ、と03にある
無料のキーなのに通らない 呼び出し先が api-free.deepl.com か確かめる(クイックスタート)
キーの場所が分からない APIは deepl.com/your-account/keys(クイックスタート)。CATは app.deepl.com/your-account の「Account」タブ(ヘルプ)
翻訳のアカウントでAPIが使えない APIには新しいアカウントが必要(クイックスタート)
deepl が見つからない(CLI) npm link まで済んだか、deepl --version で確かめる。ビルドツールの前提も確認する(ページ)
CATツールでエラー プラグインを最新にする。キーが契約に含まれているか(上の「対象のプラン」)を確かめる

外し方と取り消しの、書かれている範囲

連携 公式の記載
Docs MCP Server 認証なし。クライアント側で設定を消す方法は、DeepLのページには書かれていない
APIキー 消す・作り直す画面は、読んだページには書かれていない
CATツール キーの取り消し:記載が見つからない
CLI アンインストールの記載は、読んだページには見つからない

気をつけること

出典