AIツールへの接続手順

RAKUDA Atlas は MCP という規格で、お使いのAIツールから直接呼び出せます。 ここでは、ツールごとの設定方法をまとめています。

🔑 接続キー（rk_live_ で始まる文字列）は、管理コンソール console.atlas.rakuda.co →「API / MCP連携」→「新しいキーを発行」で取得します。 キー本体が表示されるのは発行直後の一度きりです。 この文書にはキーを記載していません。設定ファイルに直接書かず、環境変数で渡してください。

---

対応状況

0. 接続方式は2つあります

OAuth連携は、キーを発行して配る代わりに各自がログインして許可する方式です。 オペレーターが増えてもキーを配り歩かずに済みます。

---

1. Claude Code

claude mcp add --transport http atlas https://atlas.rakuda.co/mcp --header "Authorization: Bearer ここに接続キー"

確認：

claude mcp list

• Node.js と Claude Code のインストールが必要です
• Claude のご契約は Pro 以上

---

2. Codex（CLI / IDE拡張 / ChatGPTデスクトップアプリ）

~/.codex/config.toml に以下を追記してください。

[mcp_servers.atlas]
url = "https://atlas.rakuda.co/mcp"
bearer_token_env_var = "ATLAS_API_KEY"
tool_timeout_sec = 120

接続キーは環境変数で渡します。

export ATLAS_API_KEY="ここに接続キー"   # Mac
# Windows は: setx ATLAS_API_KEY "ここに接続キー"

• 実験的な設定（フラグ）は不要です
• CLI・IDE拡張・ChatGPTデスクトップアプリのいずれでも動作します
• 作業フォルダごとに分けたい場合は .codex/config.toml でも設定できます

---

3. Gemini CLI

gemini mcp add --transport http atlas https://atlas.rakuda.co/mcp --header "Authorization: Bearer ここに接続キー"

または ~/.gemini/settings.json に直接：

{
  "mcpServers": {
    "atlas": {
      "httpUrl": "https://atlas.rakuda.co/mcp",
      "headers": { "Authorization": "Bearer ここに接続キー" }
    }
  }
}

---

4. Claude デスクトップアプリ

設定ファイル claude_desktop_config.json に以下を追記してください。

{
  "mcpServers": {
    "atlas": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://atlas.rakuda.co/mcp",
        "--header",
        "Authorization: Bearer ${ATLAS_API_KEY}"
      ],
      "env": { "ATLAS_API_KEY": "ここに接続キー" }
    }
  }
}

• mcp-remote が仲介役となって接続します
• Node.js のインストールが必要です
• コマンド操作が苦手な方には、この方法が最も扱いやすい構成です

---

接続できたかの確認

AIにこう聞いてみてください。

「Atlasに接続できていますか。データベースの規模を教えてください」

法人数（約464万社）と部署数が返ってくれば、接続は成功しています。

---

うまくいかないとき

解決しない場合は、担当者にエラーメッセージをそのままお送りください。