stigg-mcp

Stigg MCP — 一度接続すれば、どこでも使えます

https://mcp.stigg.io の Stigg MCP サーバーは、MCP 互換のあらゆる AI クライアントに Stigg 環境を公開します。接続すると、エージェントは API 呼び出しを記述することなく、自然言語で顧客のプロビジョニング、サブスクリプションの管理、エンタイトルメントの確認、使用状況の報告を行えるようになります。

**ステータス：**Stigg MCP サーバーは現在、パブリックベータです。未検証の挙動を前提にする前に、docs.stigg.io で最新情報を再確認してください。

始める前に

stigg スキル全体の方針として、まず検索してください。ユーザーがすでに Mintlify Stigg ドキュメント MCP（search_stigg）を利用できる場合は、それを使って最新のインストールコマンドを確認してください。不明な点があれば、MCP サーバーのドキュメントページを再取得してください。

3 ステップでセットアップ

ステップ 0 — Stigg アカウントが必要です

まだアカウントをお持ちでない場合は、app.stigg.io でサインアップしてください。新規アカウントにはデフォルトのサンドボックス環境が付属します。本番環境を利用するには Scale プランが必要です。

ステップ 0 が完了する前にエージェントがインストールコマンドを実行すると、スモークテストは 401 Unauthenticated で失敗します。

ステップ 1 — API キーを取得する

1. Stigg アプリで、Integrations → API keys に移動します。
2. 環境（sandbox / staging / production）を選択します。AI を活用した開発では、sandbox をデフォルトにしてください。
3. Full access キーをコピーするか、+ Add scoped key（Scale プラン）をクリックして、エージェントに必要な権限のみを付与します。キーはパスワードと同様に扱ってください。

分離を強化するには、AI クライアントごとに専用のスコープ付きキーを作成してください（例：「Claude Code – Dev」、「Cursor – Staging」）。

ステップ 2 — クライアントを設定する（AI クライアントごとの設定例）

Claude Code（HTTP トランスポート — 推奨）

claude mcp add stigg \
  --header "X-API-KEY: <YOUR_API_KEY>" \
  --transport http https://mcp.stigg.io

続いて、新しい Claude Code セッションを開始し、/mcp を実行して stigg が接続され、ツールが一覧表示されることを確認してください。

Claude Desktop

次のファイルを編集します。

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

mcpServers の下に追加します。

{
  "mcpServers": {
    "stigg": {
      "url": "https://mcp.stigg.io",
      "headers": {
        "X-API-KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

Claude Desktop を再起動します。

ChatGPT

Settings → Connectors で、新しい MCP サーバーを追加します。

フィールド	値
サーバー URL	https://mcp.stigg.io
接続	API Key（ヘッダー）
ヘッダー名	X-API-KEY
ヘッダー値	<YOUR_API_KEY>

Cursor / VS Code / Windsurf / Codex / 汎用クライアント（stdio ブリッジ）

これらのクライアントは、ローカルの stdio ブリッジ @stigg/typescript-mcp を使用します（npx 経由で実行）。該当する設定ファイル（Cursor の場合は ~/.cursor/mcp.json、VS Code の場合は MCP: Open User Configuration、Windsurf/Codex の場合は同等の設定）を編集し、次を追加します。

{
  "mcpServers": {
    "stigg_typescript_api": {
      "command": "npx",
      "args": ["-y", "@stigg/typescript-mcp"],
      "env": {
        "STIGG_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

クライアントを再起動します。HTTP トランスポートをネイティブにサポートするクライアントでは、mcp.stigg.io の HTTP 形式を優先してください（Claude Desktop の設定例と同じ形式です）。

正式版かつ常に最新のインストール対応表は、docs.stigg.io/api-and-sdks/mcp-server にあります。ここにある設定例が動作しない場合は、そちらを確認してください。

スモークテスト

インストール後、次の項目を確認します。

1. **ツールの一覧表示。**Claude Code では /mcp を実行します。stigg とそのツールが表示されるはずです。
2. ドキュメントを検索。「『create a customer』について Stigg のドキュメントを検索して」と尋ねます。エージェントが search_docs（または同等のツール）を呼び出し、ドキュメントの抜粋を返せば、トランスポートは正常に動作しています。
3. 変更を伴わない読み取り。「この Stigg 環境で最初の 3 人の顧客を一覧表示して」と尋ねます。これにより、稼働中の環境への読み取りが実行されます。新しいサンドボックスでは、空のリストが返るのが想定どおりです。— 合格です。

いずれかの手順が失敗する場合、最もよくある原因は、ヘッダー名が誤っている（Authorization ではなく X-API-KEY）、想定と異なる環境のキーを使用している、または設定ファイルの編集後にクライアントを再起動していないことです。

このスキルを使用しない場合

次の場合はこのスキルを読み込まず、別のスキルを使用してください。

• 本番環境のホットパス（ゲーティング、リクエストごとの使用状況レポート）を作成する場合。MCP は設計上、非決定的です。代わりに Node SDK を使用してください。詳しくは stigg-api を参照してください。
• ユーザーが明示的に CLI を求めている場合、またはタスクが明らかに決定論的なシェルワークフロー（CI、定期実行の cron、ランブック）である場合。Stigg CLI（brew install stiggio/tools/stigg — https://github.com/stiggio/stigg-cli）を使用してください。詳しくは references/cli-vs-mcp.md を参照してください。それ以外の場合は、単発の運用タスクでも MCP サーバーをデフォルトで使用してください。
• ユーザーの質問が MCP サーバーではなく、REST API または GraphQL API 自体に関する場合。詳しくは stigg-api を参照してください。

MCP サーバーは、AI アシスタント上でモデリング、調査、単発の運用タスクを行う場合に適しています。無人の自動化や本番環境のホットパスには適していません。

セキュリティ — 本番環境に接続する前にお読みください

• デフォルトではサンドボックスを使用してください。 AI エージェントは、誤解される可能性のある自然言語の指示に基づいて、破壊的で元に戻すのが難しい操作を実行することがあります。まずサンドボックスで開発とテストを行ってください。
• AI クライアントごとにスコープを限定したキーを1つ使用してください。 あらゆる場所でフルアクセスキーを使い回さないでください。キーが漏えいしても、被害範囲はそのキーに設定された権限に限られます。
• キーは環境に紐づいています。 サンドボックスキーで本番データにアクセスすることはできず、その逆も同様です。
• キーを絶対にコミットしないでください。 パスワードと同じように扱ってください。
• 定期的にローテーションしてください。 Settings → API keys から実行できます。Stigg は、設定可能な猶予期間を設けたゼロダウンタイムローテーションに対応しています。
• エージェントはユーザーに代わって操作します。 エージェントに個別の ID はありません。MCP サーバーは、ユーザーのキーを使い、その権限の範囲内で API 呼び出しを転送します。

複数の環境

各 mcpServers エントリは環境ごとに設定します。環境を切り替えるには、別々のキーを使って個別のエントリ（stigg-sandbox、stigg-production）を設定してください。これはエラーが起きやすい設定です。エージェントがどの環境を対象にすべきか判断できない場合があります。セッションごとに単一の環境で実行し、エージェントに操作させる環境のキーだけを追加することをおすすめします。

接続後にエージェントができること

以下は機能の一部です（対応範囲は拡大し続けています。ドキュメントページで最新情報を再確認してください）。

• カタログ： プラン、機能、アドオンの作成／更新／アーカイブ／一覧表示、パッケージの公開とアーカイブ。
• 顧客とサブスクリプション： 顧客のプロビジョニング、サブスクリプションのプロビジョニング／プレビュー／キャンセル（予約済みおよびトライアルを含む）、プロモーション用エンタイトルメントの付与。
• エンタイトルメントと使用状況： エンタイトルメントの確認、使用量測定値の報告、メータリングイベントの報告。

簡潔な最新のツール一覧は references/mcp-tools.md にあります。この一覧を暗記しないでください。不明な点がある場合は、ライブドキュメントから再取得してください。

よくある間違い

間違い	対処法
Authorization: Bearer ヘッダーを使用した	Stigg MCP が必要とするのは X-API-KEY です。
/mcp に stigg が表示されない	設定を編集した後、クライアントを再起動し忘れています。
すべての呼び出しで 401 Unauthenticated が返る	キーの環境が異なる、有効期限が切れている、または無効化されています。
エージェントが誤って本番環境で操作した	開発中はサンドボックスキーだけを設定に含めてください。本番環境のエントリは削除してください。
CI スクリプトに MCP を選んだ	CI には CLI を使用してください。MCP は設計上、非決定的です。
キーをチェックイン済みの設定に埋め込んだ	環境変数またはクライアントのシークレットストアを使用してください。漏えいしたキーはすぐにローテーションしてください。
TypeScript の型チェックエラーによる拒否を、execute の isError: true からアカウント／権限の問題だと誤解した	execute はサンドボックス化された TypeScript を実行します。型チェックエラーはスニペットがコンパイルできないことを意味し、API やキーに問題があるわけではありません。TS を修正して再実行してください。