コーディングエージェントとエディター

Claude Code、Codex、Cursor、VS Code、OpenCode、Windsurf を、サインインまたは API キーで TwexAPI MCP サーバーに接続します。

以下のクライアントはすべて、Streamable HTTP で同じサーバー https://api.twexapi.io/mcp に接続します。ほとんどのクライアントは TwexAPI アカウントでサインインできます。URL だけを追加すると、クライアントがブラウザを開いてアクセスの承認を求めます。MCP のサインインに対応していないクライアントや、キーを使いたい場合は API キーを使ってください。

「検証済み」は、そのクライアントでサインインからツール呼び出しまでを実際に行ったことを意味します。その他のサインイン手順は、各ベンダーが公開している MCP 認可への対応に基づいています。サインインに失敗した場合は API キーを使ってください。Claude.ai、Claude Desktop、ChatGPT については MCP サーバーの概要 と ChatGPT を参照してください。

Claude Code

サーバーを追加します：

claude mcp add --transport http twexapi https://api.twexapi.io/mcp

続いて Claude Code のセッション内で /mcp を実行し、twexapi を選んで Authenticate を選択し、ブラウザでアクセスを承認します。--scope project を付けると .mcp.json でサーバーをチームと共有でき、メンバーはそれぞれ自分のアカウントでサインインします。

API キーを使う場合は、ヘッダーを .mcp.json に書きます。Claude Code は環境変数から ${TWEXAPI_API_KEY} を展開します：

{
  "mcpServers": {
    "twexapi": {
      "type": "http",
      "url": "https://api.twexapi.io/mcp",
      "headers": {
        "x-api-key": "${TWEXAPI_API_KEY}"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json（全プロジェクト）または .cursor/mcp.json（1 プロジェクト）に追加します：

{
  "mcpServers": {
    "twexapi": {
      "url": "https://api.twexapi.io/mcp"
    }
  }
}

Settings → MCP を開くと、サーバーに Needs authentication と表示されます。Authenticate を選択し、ブラウザでアクセスを承認して、ブラウザから Cursor を開くことを許可してください。サーバーに 3 つのツールが有効と表示されれば完了です。

API キーを使う場合：

{
  "mcpServers": {
    "twexapi": {
      "url": "https://api.twexapi.io/mcp",
      "headers": {
        "x-api-key": "${env:TWEXAPI_API_KEY}"
      }
    }
  }
}

Codex

サーバーを追加してサインインします：

codex mcp add twexapi --url https://api.twexapi.io/mcp
codex mcp login twexapi
codex mcp list

Codex CLI、アプリ、IDE 拡張機能は ~/.codex/config.toml の同じ設定を共有します：

[mcp_servers.twexapi]
url = "https://api.twexapi.io/mcp"

API キーを使う場合は、キーを保存した環境変数を指定します。Codex は Authorization: Bearer として送信します：

[mcp_servers.twexapi]
url = "https://api.twexapi.io/mcp"
bearer_token_env_var = "TWEXAPI_API_KEY"

VS Code

コマンドパレットから MCP: Add Server を実行して HTTP を選ぶか、.vscode/mcp.json に追加します：

{
  "servers": {
    "twexapi": {
      "type": "http",
      "url": "https://api.twexapi.io/mcp"
    }
  }
}

サーバーを起動し、ブラウザに表示されるサインインを承認します。

API キーを使う場合は、VS Code に一度だけ入力を求めさせ、安全に保存できます：

{
  "inputs": [
    {
      "type": "promptString",
      "id": "twexapi-key",
      "description": "TwexAPI API key",
      "password": true
    }
  ],
  "servers": {
    "twexapi": {
      "type": "http",
      "url": "https://api.twexapi.io/mcp",
      "headers": {
        "x-api-key": "${input:twexapi-key}"
      }
    }
  }
}

OpenCode

opencode.json に追加します：

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "twexapi": {
      "type": "remote",
      "url": "https://api.twexapi.io/mcp"
    }
  }
}

OpenCode はサーバーにサインインが必要なことを検出し、ブラウザを開きます。開かない場合は opencode mcp auth twexapi を実行してください。状態は opencode mcp list で確認でき、接続に失敗したときは opencode mcp debug twexapi を使います。

API キーを使う場合は、自動サインインをオフにします：

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "twexapi": {
      "type": "remote",
      "url": "https://api.twexapi.io/mcp",
      "oauth": false,
      "headers": {
        "Authorization": "Bearer {env:TWEXAPI_API_KEY}"
      }
    }
  }
}

Windsurf

Windsurf でのサインインはまだ確認できていないため、API キーを使ってください。~/.codeium/windsurf/mcp_config.json に追加します（Cascade の MCP メニューからこのファイルを開くと、お使いのバージョンでの場所を確認できます）：

{
  "mcpServers": {
    "twexapi": {
      "serverUrl": "https://api.twexapi.io/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}

その他のクライアント

MCP の認可（PKCE と動的クライアント登録を使う OAuth 2.1）を実装したクライアントであれば、サーバー URL を追加するだけでサインインできます。そうでない場合は、x-api-key ヘッダーか Authorization: Bearer YOUR_API_KEY で API キーを送ってください。独自のクライアントを作る場合は MCP クライアントの OAuth を参照してください。

接続を確認する

• サーバーには explore、twexapi_request、twexapi_write が表示されます。書き込みを許可していない場合、twexapi_write は表示されません。
• エージェントに「TwexAPI の explore でトレンド関連のエンドポイントを探して」と頼んでみてください。explore はクレジットを消費しないため、チャージ前でも使えます。
• 新しい接続は ダッシュボード の Authorized apps（認可済みアプリ）に表示されます。

問題を報告するときは、クライアント名とバージョン、UTC 時刻、確認できればレスポンスヘッダー X-Request-Id を添えてください。