Stape MCP Server について
Stape MCP Serverは、リモートHTTPエンドポイントを通じてStape REST APIをAIアシスタントやMCPクライアントに公開します。コンテナ、監視、請求、アカウントアクセス、パートナーデータ、参照情報を扱い、多くの領域で読み取りと書き込みの操作が分かれています。
主な機能
- 01リモートHTTP MCPエンドポイント
- 02コンテナ管理ツール
- 03監視、ログ、分析
- 04請求とアカウント操作
- 05EU APIリージョン対応
- 06読み取り・書き込みツールの分離
活用シーン
- 01MCPクライアントからStapeコンテナを管理
- 02コンテナの監視情報やログを確認
- 03請求情報とアカウント情報にアクセス
- 04Stape Scoreでトラッキングをスキャン
MCP 対応
リモートMCPサーバーとしてStape REST APIをラップし、操作をツールや参照リソースとして公開します。クライアントはStape APIキーで認証し、EUアカウントではヘッダーまたはURLでリージョンを指定できます。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
このサーバーのパッケージやリモートエンドポイントはまだ取得できていません。プロジェクトの README の手順に従ってください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
Stape MCP サーバー
このプロジェクトは、Stape プラットフォーム向けの MCP(Model Context Protocol)サーバーを実装しています。
目次
API ドキュメント
このサーバーは Stape REST API をラップしています。すべてのエンドポイントのリファレンスはこちらです:
前提条件
- Node.js(v20 以降)
インストール
Stape MCP サーバーは、https://mcp.stape.io/mcp にあるリモートの HTTP ベース MCP エンドポイントです。HTTP で直接通信するクライアント(Claude Code、VS Code、Copilot CLI、Cursor、Antigravity、Lovable、リクエストヘッダーを利用できる Claude Desktop のカスタムコネクター)は、そのまま接続できます。stdio のみをサポートするクライアントは、リモート HTTP MCP サーバーへの小さなブリッジである mcp-remote を介して接続します。
古い SSE ベースの MCP クライアントとの後方互換性のため、レガシーな
/sseエンドポイントも用意されています。以下の設定では使用しません。新しい統合では/mcpを使用してください。
Stape アカウントから Stape API キーを取得し、以下の ${your_stape_api_key} の代わりに使用してください(使用方法はこちら)。設定を変更した後は、クライアントを再起動してください。
Stape EU 環境を使用していますか?以下の各クライアントの設定には、EU アカウントで必要な変更が含まれています。理由については、EU エンドポイントのサポートをご覧ください。
Claude Desktop
⬇️ クリックして展開 ⬇️
カスタムコネクター(HTTP 直接接続)。 Add custom connector ダイアログに Request headers セクションがある場合(ベータ版のため、まだすべての組織で利用できるわけではありません):
- Customize → Connectors → Add custom connector に移動します。Team プランと Enterprise プランでは、代わりにオーナーが Organization settings → Connectors から追加します。その場合、すべてのメンバーがオーナーの入力したキーを使用します。組織内の全員が、書き込みツールや削除ツールを含め、同じ Stape アカウントとして操作するため、それが意図されている場合に限り設定してください。
- URL に
https://mcp.stape.io/mcpを設定し、Authentication を No sign-in に設定します。 - Request headers で
authorizationを追加し、値に Stape API キーを入力して、Required にチェックを入れ、Add を選択します。
このコネクターは claude.ai でも動作します。EU アカウントでは、URL に https://mcp.stape.io/mcp?region=eu を使用します。
mcp-remote。 Request headers がない場合は、claude_desktop_config.json(Settings → Developer → Edit Config)に以下を追加します:
{
"mcpServers": {
"stape-mcp-server": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.stape.io/mcp",
"--header",
"Authorization: ${your_stape_api_key}"
]
}
}
}
EU アカウントでは、args に "--header", "X-Stape-Region: EU" を追加します。
Claude Code
⬇️ クリックして展開 ⬇️
claude mcp add --transport http stape-mcp-server https://mcp.stape.io/mcp \
--header "Authorization: ${your_stape_api_key}"
これにより、サーバーが現在のプロジェクトにのみ追加されます。すべてのプロジェクトで使用するには --scope user を追加します。プロジェクトの .mcp.json に書き込むには --scope project を追加します(キーが含まれるため、このファイルがコミットされている場合は避けてください)。Claude Code 内で claude mcp list または /mcp を実行して、接続されたことを確認します。
EU アカウントでは、--header "X-Stape-Region: EU" を追加します。
VS Code
⬇️ クリックして展開 ⬇️
VS Code の MCP クライアントは HTTP サーバーをネイティブにサポートしているため、mcp-remote は不要です。このワークスペースでは .vscode/mcp.json に、すべてのワークスペースで使用するには MCP: Open User Configuration が開くファイルに追加します。サーバーの初回起動時に VS Code が API キーの入力を求めて保存するため、キーが設定ファイルに書き込まれることはありません:
{
"inputs": [
{
"type": "promptString",
"id": "stape-api-key",
"description": "Stape API key",
"password": true
}
],
"servers": {
"stape-mcp-server": {
"type": "http",
"url": "https://mcp.stape.io/mcp",
"headers": {
"Authorization": "${input:stape-api-key}"
}
}
}
}
EU アカウントでは、headers に "X-Stape-Region": "EU" を追加します。
⬇️ クリックして展開 ⬇️
copilot mcp add --transport http stape-mcp-server https://mcp.stape.io/mcp \
--header "Authorization: ${your_stape_api_key}"
これにより、サーバーエントリが ~/.copilot/mcp-config.json に書き込まれ、すぐに利用できるようになります。copilot mcp get stape-mcp-server を実行して、接続されたことを確認してください。インタラクティブセッション内では、/mcp add を使うとフォームから同じ操作を行えます。詳しくは、GitHub のドキュメントをご覧ください。
EU アカウントの場合は、--header "X-Stape-Region: EU" を追加してください。
GitHub Copilot
⬇️ クリックして展開 ⬇️
VS Code の GitHub Copilot Chat は VS Code 独自の MCP クライアントを使用するため、同じ .vscode/mcp.json ファイルを読み込みます。EU 向けの変更を含め、上記の VS Code をご覧ください。別途設定する必要はありません。
Cursor
⬇️ クリックして展開 ⬇️
Cursor は HTTP にも直接接続できるため、mcp-remote は不要です。.cursor/mcp.json(このプロジェクト)または ~/.cursor/mcp.json(すべてのプロジェクト)に次の内容を追加してください。
{
"mcpServers": {
"stape-mcp-server": {
"url": "https://mcp.stape.io/mcp",
"headers": {
"Authorization": "${your_stape_api_key}"
}
}
}
}
キーをファイルに記載しないようにするには、"Authorization": "${env:STAPE_API_KEY}" を設定し、シェルのプロファイルで STAPE_API_KEY をエクスポートします。Cursor のサイドバーにある Customize からサーバーを管理できます。
EU アカウントの場合は、headers に "X-Stape-Region": "EU" を追加してください。
Antigravity
⬇️ クリックして展開 ⬇️
Antigravity も HTTP に直接接続できますが、url の代わりに serverUrl を使用します。Antigravity エディターと CLI で共有される ~/.gemini/config/mcp_config.json に次の内容を追加してください。エディターでは、エージェントパネルから … → MCP Servers → Manage MCP Servers → View raw config を選択して開きます。
{
"mcpServers": {
"stape-mcp-server": {
"serverUrl": "https://mcp.stape.io/mcp",
"headers": {
"Authorization": "${your_stape_api_key}"
}
}
}
}
EU アカウントの場合は、headers に "X-Stape-Region": "EU" を追加してください。
ChatGPT
⬇️ クリックして展開 ⬇️
ChatGPT はまだ Stape MCP Server に接続できません。カスタム MCP サーバー(Plugins → + → Add custom MCP server)が受け付けるのは OAuth または認証なしのみ(OpenAI のドキュメント)ですが、Stape MCP Server は API キーで認証します。それまでは、ほかのクライアントをご利用ください。
Lovable
⬇️ クリックして展開 ⬇️
- Lovable で Connectors に移動し、右上の + を選択して、MCP server を選びます。
- Server name に
Stape、Server URL にhttps://mcp.stape.io/mcpを設定します。 - 認証方法で(デフォルトの OAuth ではなく)Bearer token or API key を選択し、Stape API キーを貼り付けます。
- Add server を選択します。
Lovable はカスタムヘッダーを送信できないため、EU アカウントでは X-Stape-Region ヘッダーの代わりに、サーバー URL として https://mcp.stape.io/mcp?region=eu を使用します。接続は個人用(チームメイトは各自で追加する必要があります)で、プロジェクトのチャットと Chats で利用できます。公開済みアプリでは利用できません。詳しくは、Lovable のドキュメントをご覧ください。
その他の MCP クライアント
⬇️ クリックして展開 ⬇️
クライアントがカスタムヘッダー付きのリモート HTTP MCP サーバーに対応している場合は、Cursor の設定例のように、Stape API キーを含む Authorization ヘッダーを設定して https://mcp.stape.io/mcp に接続してください。それ以外の場合は、mcp-remote を使用してください。
{
"mcpServers": {
"stape-mcp-server": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.stape.io/mcp",
"--header",
"Authorization: ${your_stape_api_key}"
]
}
}
}
EU アカウントの場合は、X-Stape-Region: EU ヘッダーを送信してください(mcp-remote では、args に "--header", "X-Stape-Region: EU" を追加します)。または、クライアントが URL とキーのみを受け付ける場合は、https://mcp.stape.io/mcp?region=eu を使用してください。
Stape アカウントが EU 環境にある場合、EU API を呼び出すようにサーバーへ知らせる必要があります。インストールに記載されている各クライアントの設定は、必要に応じて次のいずれか1つを追加します。
| オプション | 使用する条件 |
|---|---|
X-Stape-Region: EU ヘッダー | クライアントでヘッダーを設定できる場合(mcp-remote を使用する Claude Desktop、Claude Code、VS Code、Cursor、Antigravity、Copilot CLI) |
サーバー URL に ?region=eu を付ける(例:https://mcp.stape.io/mcp?region=eu) | クライアントが URL とキーのみを受け付ける場合(Lovable、Claude Desktop のカスタムコネクタ) |
両方が指定されている場合は、ヘッダーが優先されます。どちらも指定されていない場合、リクエストはグローバル API に送られ、EU API キーは 401 Unauthorized で拒否されます。
利用可能なツール
各ツールは、実行する操作(list、get、create、update、delete など)を選択する action パラメーターを受け取ります。破壊的な操作では、追加で confirm: true が必要です。
読み取り操作と破壊的な操作、または状態を変更する操作が混在するツールは、
_read ツール(安全な読み取り専用操作)と _write ツール(作成/更新/削除操作)に分割されています。もともとすべて読み取り操作だったツール、または破壊的ではない書き込み操作のみを含むツールは、単一のツールのままです。例外は
stape_container_proxy_files と stape_container_schedules です。これらの update
はコレクション全体を置き換え(省略された項目は削除されます)ます。
stape_container_power_ups の proxy_files と schedule の更新も同様です。また、
stape_container_subscription は、コンテナを新しい所有者に移管したり、サブスクリプションをキャンセルしたりできます。この4つはいずれも
destructiveHint: true として注釈されており、まだ分割されていません。
| 分野 | ツール |
|---|---|
| コンテナ | stape_container_read、stape_container_write、stape_container_lifecycle、stape_container_domains_read、stape_container_domains_write、stape_container_schedules、stape_container_power_ups、stape_container_proxy_files、stape_container_connections_read、stape_container_connections_write、stape_container_resources |
| モニタリングとログ | stape_container_monitoring_read、stape_container_monitoring_write、stape_container_monitoring_logs、stape_container_logs_read、stape_container_logs_write、stape_container_analytics、stape_container_statistics |
| 請求 | stape_billing、stape_consolidated_invoicing_read、stape_consolidated_invoicing_write、stape_invoices、stape_payment_links_read、stape_payment_links_write、stape_subscriptions、stape_container_subscription、stape_container_paddle |
| アカウントとアクセス | stape_account_read、stape_account_write、stape_users_read、stape_users_write、stape_user_api_keys_read、stape_user_api_keys_write、stape_company_read、stape_company_write、stape_share_access_read、stape_share_access_write |
| パートナー | stape_partner、stape_partner_payouts_read、stape_partner_payouts_write |
| Stape Score | stape_score_report — Stape Score でウェブサイトのトラッキング設定をスキャンします(スキャンの作成、結果の取得) |
| 参照データ | stape_container_resource、stape_domains_resource、stape_gateway_resource、stape_logs_resource、stape_monitoring_resource、stape_billing_resource、stape_partner_resource、stape_products、stape_calculator |
トラブルシューティング
MCP サーバー名の長さ制限
一部の MCP クライアント(Cursor AI など)には、MCP サーバー名とツール名を合わせた長さが60文字までという制限があります。設定で長いサーバー名(例:stape-mcp-server-your-additional-long-name)を使用すると、一部のツールが除外されることがあります。
この問題を避けるには:
- MCP の設定では、短いサーバー名を使用してください(例:
stape-mcp-server)
MCP キャッシュの消去
mcp-remote はすべての認証情報を ~/.mcp-auth(または MCP_REMOTE_CONFIG_DIR で指定した場所)に保存します。問題が解消しない場合は、キャッシュを消去して MCP クライアントを再起動してください。
rm -rf ~/.mcp-auth
役立つリソース
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。