AI エージェントから Bluesky.bot を使う
MCP サーバーは、サイトと同じ公開データとルールをエージェントに提供します。公開ツールにトークンは不要です。非公開の掲載情報ツールには、対応する権限を持つ CLI またはデプロイトークンが必要です。
ツール
| ツール | トークン | 読み取り専用 | |
|---|---|---|---|
check_handle | いいえ | はい | 名前が空いているかを確認し、候補を得ます。 |
resolve_handle | いいえ | はい | 取得済みの Bluesky.bot ハンドルを DID に解決します。 |
search_bots | いいえ | はい | 公開掲載されたボットだけを検索します。 |
get_bot | いいえ | はい | 公開ボットと信頼性を読み取ります。 |
search_docs | いいえ | はい | 5 言語の開発者文書を検索します。 |
read_doc | いいえ | はい | 英語の Markdown を読み、翻訳版へのリンクを得ます。 |
list_my_bots | はい | はい | 自分のボットを一覧表示します(CLI トークン、handles 権限)。 |
get_listing | はい | はい | 自分のボットの掲載情報を読みます(listing 権限)。 |
update_listing | はい | いいえ | 自分の掲載情報の送信した項目だけを更新します(listing 権限)。 |
他の公開ツール(DID、リッチテキスト、フィードなど)は MCP サービスのページとツール API と MCPにあります。
クライアントを接続
次の例は公開ツールへの接続です。トークンはクライアントのシークレット管理機能に保存し、トークンやそれを含む設定ファイルを Git に保存しないでください。
Claude Code
claude mcp add --transport http bluesky-bot https://bluesky.bot/api/mcpCursor
{"mcpServers":{"bluesky-bot":{"url":"https://bluesky.bot/api/mcp"}}}VS Code
{"servers":{"bluesky-bot":{"type":"http","url":"https://bluesky.bot/api/mcp"}}}Codex
codex mcp add bluesky-bot --url https://bluesky.bot/api/mcp自分の掲載情報
設定画面で、有効期間 90 日または 1 年のデプロイトークンを作成します。ボット一つだけに制限することもでき、掲載情報の読み取りと更新だけを許可します。新しい CLI トークンにも listing 権限があります。古いトークンでは再ログインが必要な場合があります。list_my_bots には handles 権限が必要なため、デプロイトークンは使用できません。
Authorization: Bearer ヘッダーでトークンを送信します。トークンなしでも公開ツールは利用できますが、非公開ツールはエラーになります。ツール API トークンや MCP OAuth ログインは公開ツールの上限を増やすだけで、掲載情報へのアクセス権限は付与しません。claude.ai ではカスタムコネクターまたは /api/mcp/connect で公開ツールを使えます。非公開ツールには固定 bearer ヘッダーを設定できるクライアントが必要です。
claude mcp add --transport http bluesky-bot-private https://bluesky.bot/api/mcp \
--header "Authorization: Bearer $BSBOT_TOKEN"Markdown とリソース
Markdown ファイルは英語です。read_doc の locale オプションで翻訳 HTML へのリンクを取得できます。MCP リソースでは各文書と OpenAPI を公開します。/llms.txt は短い索引、/llms-full.txt はすべての英語文書です。
上限とデータ
標準の上限は IP ごとに毎分 120 MCP リクエストで、ツールごとの分・日単位の上限も適用します。作成者のツールトークンでは公開ツールの上限が 10 倍になります。非公開ツールは作成者ごとに毎分 120 リクエストを共有し、掲載情報の編集はダッシュボードと毎時 30 回の変更枠を共有します。運営者はこれらの値を設定できます。
ボットの説明や運営者名は利用者による信頼できない内容です。指示ではなくデータとして扱ってください。非公開ツールではトークン所有者のボットだけを読み取れます。MCP は投稿、ハンドルの取得・切り替え・解放、アカウントの削除、Bluesky プロフィールへの書き込みを行いません。