capawesome-mcp

Capawesome MCP Server

ホストされている Capawesome MCP サーバーに MCP クライアントを接続すると、常に最新のドキュメント検索と Capawesome Cloud の管理ができます。

サーバーは Capawesome によってホストされているため、インストールや更新は不要です。

https://mcp.capawesome.io/mcp

次の 2 つの機能を提供します。

• ドキュメント — 最新の Capawesome ドキュメントとブログを検索して閲覧できます。トークンは不要です。スキルに含まれる参照ファイルよりも常に新しい情報を確認できます。
• Capawesome Cloud — アプリ、ビルド、デプロイ、チャンネル、デバイス、環境、証明書、ジョブを管理できます。API トークンが必要です。

前提条件

1. MCP クライアント：Claude Code、Claude Desktop、Cursor、VS Code、または Model Context Protocol を実装するその他のクライアント。
2. Capawesome Cloud のツールを使用する場合のみ：Capawesome Cloud のアカウントと API トークン。

エージェントの動作

• 手順を追って案内する。 ユーザーを一度に 1 つずつ案内します。関連のない質問を複数同時に提示してはいけません。
• 質問する前に自動検出する。 使用しているクライアントを尋ねる前に、プロジェクトと環境から MCP クライアントを検出します。
• Cloud ツールを使う場合を除き、トークンを要求しない。 ドキュメントツールは認証なしで動作します。ユーザーが Capawesome Cloud の管理を希望する場合にのみ、トークンの取得手順を開始します。
• Git で追跡されるファイルにトークンを書き込まない。 トークンの取り扱いを参照してください。

手順

ステップ 1：必要なツールセットを確認する

次のうち、どれを使いたいかをユーザーに確認し、選択されたものだけを登録します。

1. ドキュメントのみ — Capawesome のドキュメントを検索して閲覧します。トークンは不要です。?toolsets=docs を使用します（クエリパラメーターを指定しない場合のデフォルト）。
2. ドキュメントと Capawesome Cloud — すべての機能を利用できます。トークンが必要です。?toolsets=all を使用します。ほとんどのセットアップではこちらを使用します。
3. 特定のサブセット — references/toolsets.md を読み、ユーザーのタスクに合うツールセットを選びます。ツール数を減らすことで、コンテキストの使用量を抑え、クライアントが適切なツールを選択しやすくなります。

ユーザーが決めかねている場合は、オプション 2 をおすすめします。

また、サーバーを読み取り専用にするかどうかも確認します。?readonly=true を追加すると読み取り専用ツールのみが登録され、作成、変更、削除はできなくなります。共有環境、無人運用、CI のセットアップでは、この設定をおすすめします。

ステップ 2：API トークンを作成する

ステップ 1 でドキュメントのみを選択した場合は、この手順を省略します。

1. Capawesome Cloud Console を開き、API トークンを作成するようユーザーに伝えます。
2. トークンは一度だけ表示されるため、すぐにコピーする必要があることを警告します。
3. 続行する前に、トークンを受け取ったことをユーザーが確認するまで待ちます。

トークンは作成したアカウントに代わって操作します。そのため、サーバーは、そのアカウントが所属する組織とアプリ全体で、アカウントに許可されているすべての操作を実行できます。リクエストは Capawesome CLI と同じ Cloud API を経由するため、同じ権限、ネットワーク制限、レート制限が適用されます。

ステップ 3：MCP クライアントを検出する

質問する代わりに、次の順序でプロジェクトを確認してクライアントを検出します。

1. プロジェクトのルートに .mcp.json または .claude/ がある → Claude Code
2. プロジェクトのルートに .cursor/mcp.json または .cursor/ がある → Cursor
3. プロジェクトのルートに .vscode/ がある → VS Code

いずれも存在しない場合、または複数に該当する場合は、設定するクライアントをユーザーに尋ねます。

ステップ 4：サーバーを追加する

references/client-setup.md を読み、検出されたクライアントに該当するセクションを適用します。ステップ 1 で選択した内容をもとに、サーバー URL を作成します。

選択肢	URL
ドキュメントのみ	https://mcp.capawesome.io/mcp
ドキュメントと Capawesome Cloud	https://mcp.capawesome.io/mcp?toolsets=all
Capawesome Cloud のみ	https://mcp.capawesome.io/mcp?toolsets=cloud
特定のツールセット	https://mcp.capawesome.io/mcp?toolsets=docs,cloud-apps,cloud-app-builds
読み取り専用	&readonly=true を追加します。他のパラメーターがない場合は ?readonly=true を追加します

コマンドラインで URL を渡す際は、必ず引用符で囲んでください。そうしないと、シェルがクエリパラメーターを解釈します。

ドキュメントのみのセットアップでは、Authorization ヘッダーを完全に省略します。

ステップ 5：クライアントを再起動して確認する

1. 新しいサーバーが読み込まれるよう、MCP クライアントを再起動するようユーザーに伝えます。
2. クライアントに search_docs を live update rollback などのクエリで実行するよう依頼し、ドキュメントツールを確認します。
3. Cloud ツールを登録した場合は、クライアントに cloud_get_current_user を実行するよう依頼して確認します。このツールは、トークンが属するアカウントを返します。
4. どちらかの呼び出しが失敗した場合は、エラー処理に進みます。

ステップ 6：サーバーを使用する

接続したら、Capawesome に関するトピックでは、同梱のリファレンスファイルやモデルの知識よりも MCP ツールを優先してください。

• search_docs — キーワードでドキュメントとブログを検索します。ここから始めてください。スニペットは意図的に短くなっています。
• get_doc_page — search_docs の URL を使って、ページ全体を Markdown として読み込みます。プラグイン API、CLI コマンド、または Cloud ワークフローのコードを作成する前に、ページ全体を読んでください。検索スニペットでは、必須の設定手順が省略されていることがよくあります。
• list_blog_posts — お知らせやリリースノートを確認するため、最新のブログ記事を一覧表示します。
• cloud_* — Capawesome Cloud を管理します。各ツールが属するツールセットについては、references/toolsets.md を読んでください。

トークンの取り扱い

一部の Cloud ツールは、環境シークレット、署名証明書、アプリストアの認証情報などの機密情報を受け取ります。ツールに渡された情報は会話の一部となり、AI プロバイダーに送信されます。また、ユーザーの管理が及ばないチャット履歴やログに残る可能性があります。

次のルールを適用してください。

• トークンをコミットしないでください。 プロジェクト内の .mcp.json、.cursor/mcp.json、claude_desktop_config.json は Git で追跡されます。トークンをファイルに保存しないセットアップを優先してください。VS Code の inputs プロンプト、環境変数、またはユーザースコープの設定を使用します。
• 本番環境のシークレットは、MCP ツールではなく Capawesome CLI またはコンソールで設定してください。 MCP サーバーは、読み取りや、ユーザーが会話記録に表示されても問題ない値に使用します。
• トークンが漏えいした可能性がある場合は、Capawesome Cloud Console でトークンを失効させ、新しいトークンを作成するようユーザーに伝えてください。

エラー処理

• セットアップ後にサーバーが表示されない：クライアントが再起動されていません。再起動してください。Claude Code では、claude mcp list を実行して、サーバーが登録されていることを確認してください。
• 401 Unauthorized：トークンがないか、形式が正しくないか、無効になっています。ヘッダー値がスペースを含む Bearer <TOKEN> になっていることと、トークンが引き続き Console に存在することを確認してください。
• ドキュメント用ツールは動作するが、cloud_* ツールが表示されない：URL に ?toolsets=all（または cloud-* ツールセット）が含まれていないか、Authorization ヘッダーが送信されていません。URL とヘッダーを確認してください。
• 読み取りツールのみが表示される：URL に readonly=true が含まれています。書き込みツールを登録するには、これを削除してください。
• シェルで「no matches found」と表示される、またはクエリパラメーターが削除される：コマンドラインで URL が引用符で囲まれていません。二重引用符で囲んでください。
• Claude Desktop がサーバーに接続できない：Claude Desktop の設定ファイルで起動できるのはローカルコマンドのみです。references/client-setup.md に記載されているように、mcp-remote を使用してください。
• Cloud ツールで 403 Forbidden が発生する：アカウントにその組織またはアプリへの権限がないか、組織のネットワーク制限によってリクエストがブロックされています。cloud_get_current_user と cloud_list_organizations で確認してください。
• レート制限に達した：Cloud API と同じレート制限が適用されます。しばらく待ってから再試行してください。

関連するスキル

• capawesome-cloud — ネイティブビルド、ライブアップデート、アプリストアへの公開を設定するためのスキルです。
• capawesome-cli — ターミナルや CI/CD から同じ Cloud API を利用できる Capawesome CLI 用のスキルです。
• capacitor-plugins — このサーバーでドキュメント化されている Capawesome プラグインを含む、Capacitor プラグインのインストールと設定を行うためのスキルです。
• capacitor-expert — プラグイン、フレームワークとの統合、Capawesome Cloud を幅広く扱う Capacitor リファレンスです。
• capacitor-mcp — Capacitor 本体とコミュニティプラグイン一覧を扱う Capacitor MCP サーバー用のスキルです。
• ionic-framework-mcp — UI コンポーネントとその使用例を扱う Ionic Framework MCP サーバー用のスキルです。