MCP 経由で Infisical を Cursor に接続する方法

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Infisical をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

Infisical + Cursor

Cloud US、Cloud EU、セルフホストの Infisical によるシークレット管理に、マシン ID としてサインインします。プロジェクト、環境、フォルダーとシークレットのインポート、シークレットの名前とメタデータ、依頼に応じた個別のシークレット値、タグ、プロジェクトメンバー、ID、監査ログを扱えます。シークレット、フォルダー、環境、タグの作成とシークレットの更新ができ、シークレットの削除はインストール時にオフです。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

INFISICAL_URL, INFISICAL_CLIENT_ID, INFISICAL_CLIENT_SECRET

ステップ 1 — 認証情報を取得

設定は約 5 分で、Infisical 組織の管理者が必要です。コネクタは Universal Auth を使うマシン ID（Machine Identity）としてサインインします。

1. Infisical で Organization、Access Control、Machine Identities（旧バージョン: Organization Settings、Identities）を開き、Create Identity をクリックします。名前は例えば AnythingMCP とし、組織ロール Member またはカスタムロールを割り当てます。監査ログを読むには、監査ログへのアクセス権があるロールが必要です。
2. ID に認証方式 Universal Auth を追加します。アクセストークンの TTL（既定 30 日）はそのままでも短くしてもかまいません。コネクタは自動で再ログインします。Client Secrets で usage limit 0（無制限）のシークレットを作成します。新しいログインのたびに 1 回使われるためです。Trusted IPs を設定する場合は、AnythingMCP サーバーの送信元アドレスを含めてください。
3. Client ID（UUID）を INFISICAL_CLIENT_ID に、一度だけ表示される Client Secret を INFISICAL_CLIENT_SECRET にコピーします。
4. ID がアクセスすべき各プロジェクトに追加します。プロジェクトで Access Control、Machine Identities、Add Identity を開き、読み取りのみならロール Viewer、書き込むなら Developer かカスタムロールを選びます。ロールは必要な環境とパスに絞ってください。
5. INFISICAL_URL に https://app.infisical.com（Cloud US）、https://eu.infisical.com（Cloud EU）、または自前のインスタンスのアドレスを、/api と末尾のスラッシュなしで設定します。
6. コネクタをインストールし、infisical_list_projects を実行します。ログインを確認し、ID が属するプロジェクトを一覧表示します。

コネクタは /api/v1/auth/universal-auth/login でログインし、アクセストークンを Authorization: Bearer として送信し、自動で更新します。

シークレット値は AI に届きます: Infisical は読み取り権限のある相手に値を平文で返し、このコネクタが読み書きする値はすべて会話と AI プロバイダーを通ります。そのため infisical_list_secrets と infisical_get_secret は名前とメタデータだけを返します（値を送らないよう Infisical に指示します）。値を返す唯一のツールは infisical_read_secret_value で、1 回の呼び出しで 1 つのシークレットだけを読みます。AI はあなたがその値を求めたときにだけ使います。infisical_create_secret と infisical_update_secret に渡す値も会話を通ります。チャットに値を一切出したくない場合は、ワークスペース管理者が infisical_read_secret_value をオフにするか、値の読み取り権限のないロールを ID に割り当てます。Infisical は値の読み取りをすべて監査ログに記録します。

読み取れる内容: ID の組織（infisical_get_identity_details）、環境（名前、slug、ID）付きのプロジェクト、環境のフォルダー（一覧、または recursive でツリー全体）、シークレットのインポート（フォルダーがシークレットを継承する別の環境やパス）、バージョン、コメント、タグ、メタデータ、タイムスタンプ付きのシークレット名（tag_slugs や metadata_filter で絞り込み可能、infisical_get_secret で 1 つのシークレットのメタデータや過去の version）、タグ、ロール付きのプロジェクトメンバー、プロジェクトの ID と組織の ID、そして組織の監査ログ（infisical_list_audit_logs）です。監査ログはプロジェクト、環境、シークレット、操作者、get-secret、update-secret、delete-secret などのイベント種別、日付で絞り込め、誰がシークレットを読んだか変更したかを調べられます。infisical_read_secret_value は expand_secret_references が false でない限り、${DB_HOST} のような参照を解決します。

書き込める内容: infisical_create_secret、infisical_update_secret（新しい値、new_secret_name による名前変更、コメント、タグ。tag_ids はタグの一覧全体を置き換えます）、infisical_create_folder、infisical_create_environment、infisical_create_tag。Infisical はシークレットの前のバージョンを保持するため、値の変更はダッシュボードで元に戻せます。シークレットを読むアプリは次回の取得時に新しい値を受け取るので、AI は本番環境に書き込む前に環境をあなたに確認します。環境に変更承認ポリシーがある場合、作成や更新はシークレットをすぐには変えず、Infisical に承認リクエストを作成します。

インストール時はオフ: infisical_delete_secret。このコネクタからは元に戻せず、そのシークレットを読むすべてのアプリとパイプラインが動かなくなるため、チームが必要なときにワークスペース管理者がオンにします。

データ形式: ID は UUID です。環境は slug（dev、staging、prod）で、プロジェクトは ID で指定します。パスは / で始まり、/ だけならルートです。version はシークレットの変更回数で、secretValueHidden: true は値が送られなかったことを示します。時刻は UTC の ISO 8601 です。

ページング: infisical_list_audit_logs（既定 20 件）、infisical_list_project_identities、infisical_list_org_identities（既定 100 件）は offset と limit でページングします。ページが満杯で返る間、AI は offset を増やして再度取得します。その他の一覧は 1 回の応答ですべて返ります。

制限: Infisical Cloud では、クライアント IP ごと 1 分あたり、プランに応じて読み取り 200〜600 回、書き込み 90〜300 回、シークレット操作 120〜500 回、合計 600 リクエストまで可能です。429 には待つべき秒数が示されます。監査ログの保存期間はプランによります。セルフホストの Infisical では、コネクタが使う v4 シークレット API のためにバージョン 0.150 以降が必要です。

よくあるエラー: 401、または TokenError 付きの 403 はログイン失敗です。Client ID や Client Secret の誤り、失効、期限切れ、使用上限に達した client secret、INFISICAL_URL のリージョン違い、Trusted IPs 外の IP が原因です。403 PermissionDenied は ID のロールがそのプロジェクト、環境、パス、操作を許可していないことを示します。404 は ID、slug、パス、シークレット名の誤りです。名前は大文字と小文字を区別します。

インストール時に有効なツールでは、コネクタはシークレットを削除しません。1 回の呼び出しで読む値は最大 1 つで、メンバー、ロール、マシン ID は変更せず、証明書や KMS キーも管理しません。

ステップ 2 — アダプターをインストール

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

ステップ 3 — Cursor にコネクタを追加

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Cursor は ~/.cursor/mcp.json から MCP サーバーを読み込みます。次のエントリを追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、Cursor を再起動します。
3. Cursor → Settings → MCP を開き、anythingmcp が一覧にあり接続済みであることを確認します。
4. チャットを始めましょう。エージェントが Infisical のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「backend プロジェクトの prod 環境にはどのシークレットがありますか？ 名前だけで、値は不要です。」
• 「過去 7 日間に本番環境のシークレット STRIPE_SECRET_KEY を変更したのは誰ですか？」
• 「api プロジェクトの staging 環境にある DATABASE_URL の値を見せてください。」
• 「dev にフォルダー /payments を作成し、値 https://example.com/hooks/payments のシークレット PAYMENTS_WEBHOOK_URL を追加してください。」
• 「web プロジェクトにアクセスできるマシン ID とユーザーは誰で、どのロールですか？」

FAQ

Cursor の無料プランでカスタム MCP サーバーは使えますか? はい。MCP は Hobby、Pro、Business の各プランで利用できます。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続
• Gemini に接続
• Meta Muse に接続
• Microsoft Copilot に接続