skills.pontech.devPERSONAL INDEX

MCP connection / Streamable HTTP

AIクライアント接続

MCP URL、認証、疎通確認をクライアント別に示します。

01 / Codex

Codex

~/.codex/config.toml に追記し、キーは環境変数へ置きます。Codex CLIとIDE拡張は同じ設定を共有します。

[mcp_servers.pontech_skills]
url = "https://skills.pontech.dev/mcp"
bearer_token_env_var = "PONTECH_SKILLS_TOKEN"
疎通確認
codex mcp list またはCodex内の /mcp で search_skills が見えることを確認します。

02 / Claude

Claude Code

HTTP transportをuser scopeへ追加します。環境変数展開を使うため、キーを共有設定へ直書きしません。

claude mcp add-json --scope user pontech-skills '{"type":"http","url":"https://skills.pontech.dev/mcp","headers":{"Authorization":"Bearer ${PONTECH_SKILLS_TOKEN}"}}'
疎通確認
claude mcp list を実行し、Claude Code内の /mcp から接続状態を確認します。

03 / Gemini

Gemini CLI

~/.gemini/settings.json の mcpServers へ追加します。Gemini CLIの直接HTTP接続は httpUrl とAuthorization headerを使います。

{
  "mcpServers": {
    "pontech-skills": {
      "httpUrl": "https://skills.pontech.dev/mcp",
      "headers": {
        "Authorization": "Bearer <issued-token>"
      },
      "timeout": 10000
    }
  }
}
キーの扱い
この例のプレースホルダーはローカルで置換し、設定ファイルをリポジトリへ入れません。疎通は /mcp または /mcp refresh で確認します。

04 / Failure check

接続できないとき

  1. MCP URLが /mcp で終わっているか確認する。
  2. Authorization headerが Bearer <key> になっているか確認する。
  3. 管理画面でキーが失効、期限切れになっていないか確認する。
  4. クライアントを再起動し、tools/listを取り直す。