mcpField
S
Stape MCP Server

Stape MCP Server

ローカル
github.com/stape-io開発ツール182 週間前に更新

Stape MCP Server について

Stape MCP Serverは、リモートHTTPエンドポイントを通じてStape REST APIをAIアシスタントやMCPクライアントに公開します。コンテナ、監視、請求、アカウントアクセス、パートナーデータ、参照情報を扱い、多くの領域で読み取りと書き込みの操作が分かれています。

主な機能

  1. 01リモートHTTP MCPエンドポイント
  2. 02コンテナ管理ツール
  3. 03監視、ログ、分析
  4. 04請求とアカウント操作
  5. 05EU APIリージョン対応
  6. 06読み取り・書き込みツールの分離

活用シーン

  1. 01MCPクライアントからStapeコンテナを管理
  2. 02コンテナの監視情報やログを確認
  3. 03請求情報とアカウント情報にアクセス
  4. 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 セクションがある場合(ベータ版のため、まだすべての組織で利用できるわけではありません):

  1. Customize → Connectors → Add custom connector に移動します。Team プランと Enterprise プランでは、代わりにオーナーが Organization settings → Connectors から追加します。その場合、すべてのメンバーがオーナーの入力したキーを使用します。組織内の全員が、書き込みツールや削除ツールを含め、同じ Stape アカウントとして操作するため、それが意図されている場合に限り設定してください。
  2. URL に https://mcp.stape.io/mcp を設定し、Authentication を No sign-in に設定します。
  3. 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 CLI
⬇️ クリックして展開 ⬇️
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
⬇️ クリックして展開 ⬇️
  1. Lovable で Connectors に移動し、右上の + を選択して、MCP server を選びます。
  2. Server name に Stape、Server URL に https://mcp.stape.io/mcp を設定します。
  3. 認証方法で(デフォルトの OAuth ではなく)Bearer token or API key を選択し、Stape API キーを貼り付けます。
  4. 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 を使用してください。

## 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 Scorestape_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

役立つリソース

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。