---
title: "コーディングエージェントとエディター"
description: "Claude Code、Codex、Cursor、VS Code、OpenCode、Windsurf を、サインインまたは API キーで TwexAPI MCP サーバーに接続します。"
---

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

| クライアント | TwexAPI でサインイン | API キー | TwexAPI で検証済み |
| --- | --- | --- | --- |
| [Claude Code](#claude-code) | 対応 | 対応 | いいえ |
| [Cursor](#cursor) | 対応 | 対応 | はい |
| [Codex](#codex) | 対応 | 対応 | いいえ |
| [VS Code](#vs-code) | 対応 | 対応 | いいえ |
| [OpenCode](#opencode) | 対応 | 対応 | いいえ |
| [Windsurf](#windsurf) | 未確認 | 対応 | いいえ |

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

:::tip
  API キーはコミットする設定ファイルではなく、環境変数に保存してください。キーは [TwexAPI ダッシュボード](https://twexapi.io/dashboard) で作成できます。
:::

<a id="claude-code"></a>

## Claude Code

サーバーを追加します：

```bash
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}` を展開します：

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

<a id="cursor"></a>

## Cursor

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

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

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

API キーを使う場合：

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

<a id="codex"></a>

## Codex

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

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

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

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

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

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

<a id="vs-code"></a>

## VS Code

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

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

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

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

```json
{
  "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}"
      }
    }
  }
}
```

<a id="opencode"></a>

## OpenCode

`opencode.json` に追加します：

```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 キーを使う場合は、自動サインインをオフにします：

```json
{
  "$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}"
      }
    }
  }
}
```

<a id="windsurf"></a>

## Windsurf

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

```json
{
  "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](/mcp/oauth) を参照してください。

## 接続を確認する

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

| 問題 | 対処 |
| --- | --- |
| `401` または "Needs authentication" | クライアントのサインインをやり直します（Claude Code では `/mcp`、Cursor では **Authenticate**、または `codex mcp login`、`opencode mcp auth`）。 |
| 同意ページに API キーがないと表示される | ダッシュボードでキーを作成し、10 分以内に再度 **Approve** を選択します。 |
| 同意ページにクレジットがないと表示される | チャージしてから、10 分以内に再度 **Approve** を選択します。 |
| ツール呼び出しが "No credits left on this TwexAPI account" を返す | ダッシュボードでチャージしてください。接続自体は問題ありません。 |
| `twexapi_write` がない | 読み取り専用で接続しています。ダッシュボードでアプリを取り消し、書き込みのチェックを入れたまま再接続してください。 |

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