Zenn
🐙

Claude Code へ o3 MCP を導入してハマった話

に公開
o3
Claude Code
tech

はじめに

yoshikoさんの記事を読んで、Claude CodeでMCP（Model Context Protocol）サーバーのo3-search-mcpを設定しようとしたところ、思わぬところでハマってしまいました。

この記事では、私が遭遇した問題と、最終的にたどり着いた正しい設定方法を共有します。

TL;DR

  • ~/.config/Claude/config.jsonを編集してもMCPサーバーは反映されない
  • claude mcp addコマンドを使うのが正解
  • 設定後はClaude Codeの再起動が必要

遭遇した問題

1. config.jsonを編集しても反映されない

最初、記事を参考に~/.config/Claude/config.jsonを直接編集しました：

{
  "mcpServers": {
    "o3": {
      "command": "npx",
      "args": ["o3-search-mcp"],
      "env": {
        "OPENAI_API_KEY": "sk-proj-xxxxx",
        "SEARCH_CONTEXT_SIZE": "medium",
        "REASONING_EFFORT": "medium"
      }
    }
  }
}

しかし、Claude Codeを再起動して/mcpコマンドを実行しても：

> /mcp 
  ⎿  No MCP servers configured. Run `claude mcp` or visit 
     https://docs.anthropic.com/en/docs/claude-code/mcp to learn more.

設定が反映されませんでした。

2. APIキーが改行されてJSONが壊れる

OpenAI APIキーを設定する際、長いキーが勝手に改行されてしまい、JSONフォーマットが壊れてしまうことも：

"OPENAI_API_KEY": "sk-proj-...
",  // ← ここで改行されてしまう

正しい設定方法

最終的に、claude mcp addコマンドを使うことで問題が解決しました。

手順1: o3-search-mcpの追加

claude mcp add o3 -s user \
  -e OPENAI_API_KEY="your-openai-api-key" \
  -e SEARCH_CONTEXT_SIZE=medium \
  -e REASONING_EFFORT=medium \
  -- npx o3-search-mcp

成功すると以下のメッセージが表示されます：

Added stdio MCP server o3 with command: npx o3-search-mcp to user config

手順2: 設定の確認

claude mcp list

出力例：

o3: npx o3-search-mcp

手順3: Claude Codeの再起動

設定を反映させるために、一度Claude Codeを終了して再起動します：

# Claude Code内で
/exit

# ターミナルで再度起動
claude

手順4: MCPサーバーの確認

再起動後、/mcpコマンドで確認すると、MCPサーバーが利用可能になっているはずです。

追加のTips

複数のMCPサーバーを設定する場合

Slackサーバーなど、他のMCPサーバーも同様に追加できます：

claude mcp add slack -s user \
  -e SLACK_BOT_TOKEN="xoxb-xxxxx" \
  -e SLACK_TEAM_ID="T06EW1FJ9T6" \
  -e SLACK_CHANNEL_IDS="C07C9CMPX0V" \
  -- npx -y @modelcontextprotocol/server-slack

環境変数の管理

APIキーなどの機密情報は、環境変数として管理することもできます：

export OPENAI_API_KEY="your-api-key"
claude mcp add o3 -s user \
  -e OPENAI_API_KEY="$OPENAI_API_KEY" \
  -e SEARCH_CONTEXT_SIZE=medium \
  -e REASONING_EFFORT=medium \
  -- npx o3-search-mcp

まとめ

Claude CodeのMCP設定は、以下の点に注意が必要です：

  1. config.jsonの直接編集は効果がない - claude mcp addコマンドを使用する
  2. 長いAPIキーは引用符で囲む - JSONフォーマットが壊れないように注意
  3. 設定後は再起動が必要 - /exitして再度claudeを実行

これらの点を押さえれば、スムーズにMCPサーバーを設定できるはずです。

参考リンク

この記事が、同じような問題に遭遇した方の助けになれば幸いです。Happy coding with Claude Code! 🚀

Discussion