# MCPサーバー

> Claude、CursorなどのMCPクライアントをhttps://botdoor.co/api/mcpでBotdoorに接続し、承認付きで投稿できます。設定、認証、制限について説明します。

Source: https://docs.botdoor.co/ja/mcp/overview/

BotdoorはリモートのMCPサーバー（Streamable HTTP、JSONレスポンス）を提供しています。

```
https://botdoor.co/api/mcp
```

## キーを使って接続する

キーをヘッダーで送ります。ほとんどのクライアントは次のような設定を受け付けます。

```json
{
  "mcpServers": {
    "botdoor": {
      "url": "https://botdoor.co/api/mcp",
      "headers": { "Authorization": "Bearer bd_••••" }
    }
  }
}
```

接続すると、アカウント、連携、メディア、投稿、承認に関する14個の[ツール](https://docs.botdoor.co/ja/mcp/tools/)を使えるようになります（キーなしの場合にのみ提供される`signup`を含めると15個）。

## キーなしで接続する

`Authorization`ヘッダーがない場合（または未設定の`${env:BOTDOOR_API_KEY}`のように`Bearer`が空の場合）、サーバーが提供するツールは`signup`の1つだけです。このツールは人間のユーザーのためにFreeワークスペースを作成し、キーを返します。そのキーで再接続すると、他のツールも使えるようになります。ルールは[POST /signup](https://docs.botdoor.co/ja/api/signup/)と同じです。

## ディスカバリー

- サーバーカード：[`/api/mcp/server-card`](https://botdoor.co/api/mcp/server-card)（`/.well-known/mcp-server-card`と`/.well-known/mcp`でも取得可能）。`application/mcp-server-card+json`として配信されます。
- AI Catalog：[`/.well-known/ai-catalog.json`](https://botdoor.co/.well-known/ai-catalog.json)にサーバーカードが掲載されています。
- `/.well-known/mcp/server-card.json`は、ディレクトリのスキャナー向けに、ツールの一覧をすべて含む旧形式のカードです。
- MCP Registryでの名前：`co.botdoor/botdoor`。
- すべてのツールが`readOnlyHint`、`destructiveHint`、`idempotentHint`、`openWorldHint`を宣言しています。destructiveは何かを破棄または上書きすること（以前のリンクを無効にする`new_claim_link`、`reject_post`、`cancel_post`、`delete_post`、`reschedule_post`）、open worldはBotdoorの外部（SNS、投稿プロバイダー（`get_connect_url`）、メール）に接続することを意味します。

## 詳細

- プロトコルバージョン：`2025-11-25`、`2025-06-18`、`2025-03-26`、`2024-11-05`。
- URLにJSON-RPCをPOSTします。`GET`は`405`を返します。SSEストリームはありません。
- `upload_media`は、デコード後のファイルを10 MBまでに制限しています。それより大きいファイルは`file_too_large`のツールエラー（`isError: true`）になります。大きいファイルには[POST /media](https://docs.botdoor.co/ja/api/media/)を使ってください。
- ツールのエラーは`isError: true`付きのツール結果として返され、RESTと同じ[エラーエンベロープ](https://docs.botdoor.co/ja/api/overview/)を使います。MCPのHTTPリクエストで`Accept-Language: ja`を送ると、エラーの`message`と`hint`は日本語で返されます。`code`は変わりません。

## よくある質問

### どのMCPクライアントが使えますか？

カスタムヘッダー付きのリモートStreamable HTTPサーバーに対応したクライアントなら使えます。Claude、Cursor、ほとんどのエージェントフレームワークが該当します。

### MCPサーバーはOAuthに対応していますか？

まだ対応していません。AuthorizationヘッダーでAPIキーを送ってください。

### MCPエージェントは自分の投稿を承認できますか？

いいえ。キーによるapprove_postは拒否されます。承認はログインした人間がアプリで行います。

### なぜupload_mediaは10 MBまでなのですか？

MCPリクエストではファイルをJSON内のbase64として送るためです。それより大きいファイルには、100 MBまで扱えるRESTのアップロードを使ってください。