capawesome

Capawesome MCP Server

Capawesome の公式 MCP サーバーです。AI アシスタントに、プラグイン、Capawesome Cloud、Capawesome Insiders、CLI など、最新の Capawesome ドキュメントを提供します。また、API トークンを使用すると、アプリ、チャンネル、ビルド、デプロイなどを管理する Capawesome Cloud 管理 API も利用できます。

Capawesome がメンテナンスしています。

エンドポイント

サーバーはホストされており、すぐに利用できます。

https://mcp.capawesome.io/mcp

ドキュメントツールは、アカウントもトークンも不要です。Capawesome Cloud ツールは、リクエストに API トークンが含まれている場合にのみ利用できます。詳しくは認証をご覧ください。

インストール

Claude Code

ドキュメントツールにはトークンは不要です。

claude mcp add --transport http capawesome https://mcp.capawesome.io/mcp

Capawesome Cloud ツールを追加するには、ベアラーヘッダーとして API トークンを渡し、ツールセットを選択します。

claude mcp add --transport http capawesome "https://mcp.capawesome.io/mcp?toolsets=all" \
  --header "Authorization: Bearer YOUR_TOKEN"

Claude Desktop / Claude.ai

Settings → Connectors → Add custom connector に移動し、次の内容を入力します。

• Name：Capawesome
• URL：https://mcp.capawesome.io/mcp

Cursor

または、プロジェクトに .cursor/mcp.json を追加します。

{
  "mcpServers": {
    "capawesome": {
      "url": "https://mcp.capawesome.io/mcp"
    }
  }
}

VS Code

VS Code にインストール

または、プロジェクトに .vscode/mcp.json を追加します。

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

Windsurf

サーバーを ~/.codeium/windsurf/mcp_config.json に追加します。

{
  "mcpServers": {
    "capawesome": {
      "serverUrl": "https://mcp.capawesome.io/mcp"
    }
  }
}

Zed

サーバーを Zed の settings.json に追加します。

{
  "context_servers": {
    "capawesome": {
      "url": "https://mcp.capawesome.io/mcp"
    }
  }
}

npx 経由で任意のクライアントを使用する

HTTP 経由でリモートサーバーに接続できないクライアントでは、このパッケージを実行できます。このパッケージは stdio をホストされたサーバーにプロキシします。

{
  "mcpServers": {
    "capawesome": {
      "command": "npx",
      "args": ["-y", "@capawesome/mcp"],
      "env": {
        "CAPAWESOME_TOKEN": "your-token"
      }
    }
  }
}

Node.js 22 以降が必要です。ドキュメントツールのみを使用する場合は、env を省略してください。

認証

Capawesome Cloud Console で API トークンを作成し、サーバーに渡します。

HTTP 経由で接続する場合は、Authorization: Bearer <token> ヘッダーとして送信します。このパッケージを実行する場合は、CAPAWESOME_TOKEN 環境変数を設定すると、プロキシが代わりにヘッダーを送信します。

トークンがない場合、登録されるのはドキュメントツールのみです。Capawesome Cloud ツールは非表示になるのではなく、登録されません。

設定

次の環境変数でプロキシを設定します。これらはこのパッケージにのみ適用されます。HTTP 経由の場合は、同等のヘッダーとクエリパラメーターを使用してください。

変数	用途
CAPAWESOME_TOKEN	Authorization: Bearer として送信される API トークンです。任意です。指定しない場合は、ドキュメントツールのみ利用できます。
CAPAWESOME_MCP_TOOLSETS	登録するツールセットをカンマ区切りで指定し、?toolsets= として送信します。すべての Capawesome Cloud ツールセットには cloud、すべてのツールセットには all を指定します。デフォルトは docs です。
CAPAWESOME_MCP_READONLY	true に設定すると、書き込みまたは削除を行うすべてのツールを除外し、?readonly=true として送信します。
CAPAWESOME_MCP_URL	エンドポイントを上書きします。開発時のみ使用してください。

ツール

サーバーは、ドキュメントツール（search_docs、get_doc_page、list_blog_posts）と、ツールセットごとにグループ化された Capawesome Cloud 管理 API 用の cloud_* ツールを公開します。

ツールとツールセットの全リファレンスについては、MCP ドキュメントをご覧ください。

レート制限

エンドポイントには、IP アドレスごとに 1 分あたり 100 リクエストの制限があります。制限を超えたリクエストには 429 Too Many Requests が返されます。しばらく待ってから再試行してください。

プライバシー

IP アドレスはレート制限の目的でのみ処理されます。クエリとツールの引数は保存されず、Cloudflare の標準的なエッジログを超えて記録されることもなく、トレーニングに使用されることもありません。API トークンは、お客様に代わって Capawesome Cloud API で認証するために使用され、サーバーには保存されません。詳しくはプライバシーポリシーをご覧ください。

関連

• Capacitor MCP Server — Capacitor のドキュメント、プラグイン一覧、ブログに対応した非公式の MCP サーバーです。
• Ionic Framework MCP Server — Ionic Framework のドキュメント、コンポーネント、使用例に対応した非公式の MCP サーバーです。
• Capawesome Cloud Live Updates — アプリストアの審査を受けずに、JavaScript、HTML、CSS の変更をアプリに配信できます。
• Capawesome Cloud Native Builds — Mac を使わずに、クラウドでネイティブの iOS アプリと Android アプリをビルドできます。
• Capawesome Cloud App Store Publishing — ビルドを Apple App Store と Google Play Store に提出できます。

開発

npm install
npm run build
npm test

ホストされているサーバーの代わりにローカルサーバーをプロキシの接続先にするには、CAPAWESOME_MCP_URL を設定します。

CAPAWESOME_MCP_URL=http://localhost:8787/mcp node dist/index.js

リリース

リリースはrelease-pleaseで管理されています。リリース用プルリクエストをマージすると、バージョンにタグが付けられ、パッケージが npm に公開され、その後 server.json がMCP Registryに公開されます。server.json のバージョンは、package.json とともに release-please によって更新されるため、手動で編集する必要はありません。レジストリに手動で公開するには、mcp-publisherをインストールし、パスワードマネージャーに保存されている Ed25519 秘密鍵を使って mcp-publisher login dns --domain=capawesome.io --private-key=<key> を実行してから、mcp-publisher publish を実行します。

ライセンス

LICENSEをご覧ください。