3Min API
メニュー経路: 設定 > AI連携 > CLI / IDE

MCP連携 (CLI / IDE)

概要

AI連携は、Claude CodeやCursorのようなAIツールを3Min APIに接続して、いつものチャットのように自然言語でエンドポイントを運用する機能です。内部的には MCP（Model Context Protocol） という標準を使っています。AIが3Min APIサーバーに接続されると、当サービスが公開しているツールをAIが選んで利用し、回答を組み立ててくれます。

メリットは明確です。コードなしで新しいエンドポイントを作成し、昨日入ってきた呼び出しログを検索し、協力者を招待し、今月の使用量を確認できます。ダッシュボードを直接クリックしなくても、「先週失敗した呼び出しを5件まとめて」の一言で済みます。

3Min APIは2つの認証方式に対応しています。ChatGPTとClaudeはOAuth（3Min APIアカウントでログイン）方式なのでAPIキーの管理は不要、Claude CodeやCursorのようなCLI/IDEツールはAPIキー方式でローカル設定ファイルにキーを置いて使います。このページでは APIキー方式でローカルツールを接続する方法を案内します。

開始場所

  • ダッシュボード → 設定 → AI連携 → CLI / IDE タブ

できること

3Min APIのMCPサーバーは下記のツールをAIに公開しています。AIはユーザーのリクエストを見て適切なツールを選びます。すべての操作は 本人アカウントのデータに限定 され、他のユーザーのリソースには絶対にアクセスできません。

参照ツール

ツール名 説明 権限
help 3Min APIサービスガイドをトピック別に返す 公開
endpoints (list / get) エンドポイント一覧・詳細の参照 本人所有
logs (lookup / search / fetch archived) 単件ログ参照、テキスト検索、アーカイブ済みペイロードのリモート参照 本人所有
stats 月別・日別のAPI使用量統計 本人所有
subscription 現在のプラン・使用量・請求情報 本人アカウント
archives (list / download) アーカイブファイル一覧 + 一時ダウンロードURL発行 本人所有
collaborators (list_keys / list_invitations) コラボレーションキーおよび協力者招待一覧 本人所有

作成・更新・デプロイツール

ツール名 説明 権限
endpoints (create) 新しいエンドポイントを作成 本人アカウント
endpoints (update) フィールド定義・Webhook・通知設定の更新 本人所有
endpoints (deploy) サンドボックス設定を本番にデプロイ 本人所有
collaborators (create_key) 新しいコラボレーションキーを作成 本人所有
collaborators (update_permissions) コラボレーションキーのCRUD権限を更新 本人所有
collaborators (invite) 協力者の招待メールを送信 本人所有

実行ツール

ツール名 説明 権限
api_call (GET / POST / PUT / DELETE) 本人がデプロイしたエンドポイントへHTTPリクエストを実行（ゲートウェイ経由） 本人所有

api_call の DELETE は、ユーザーが定義したエンドポイントのビジネスロジック（例：注文キャンセルAPI）を呼び出す動作です。エンドポイント自体を削除する動作ではありません。

セキュリティと事故防止：AIに公開しない操作

下記の操作は 意図的にMCPから除外 しています。AIの誤動作や意図しない呼び出しによるデータ消失・課金事故を防ぐためで、必要な場合は https://3minapi.com に直接ログインして実行してください。

非公開操作 実行場所
エンドポイント削除 ダッシュボード → APIs → エンドポイント詳細
コラボレーションキー削除・無効化、APIキー再発行 ダッシュボード → APIs → エンドポイント詳細 → コラボレーションキー
協力者招待の取り消し ダッシュボード → APIs → エンドポイント詳細 → 協力者
プラン変更・解約 ダッシュボード → 設定 → サブスクリプション
MCP APIキー再発行・削除 ダッシュボード → 設定 → AI連携 → CLI / IDE
アーカイブファイル削除 ダッシュボード → APIs → アーカイブ
アカウント削除 ダッシュボード → 設定 → プロフィール

連携方法

CLI/IDEツールは APIキー方式 で接続されます。ローカルの設定ファイルに3Min APIのMCP APIキーを一度入れておけば、それ以降そのツールでは常に本人アカウントとして認証されます。APIキーは一度しか表示されないので、発行直後にすぐにコピー してください。

ステップ1 — CLI / IDEタブに進む

MCP APIキーがまだないCLI / IDEタブの画面

ダッシュボード右上のアカウントメニュー → 設定 → AI連携 → CLI / IDE タブに移動します。

ステップ2 — MCP APIキーを発行

MCP APIキーを生成 ボタンを押します。tm_mcp_ で始まるキーが一度だけ表示されます。

この画面を離れるとキー全体は再表示できません。 横のコピーボタンですぐにコピーして、安全な場所に保管してください。紛失した場合はキーを新規発行する必要があり、既存のキーは即座に無効化されます。

MCP APIキーが発行され、マスクされたキーとメタデータが表示されたCLI / IDEタブの画面

ステップ3 — 設定スニペットをコピー

画面下部の 設定コード カードに表示されるJSONをそのままコピーします。発行されたキーが自動入力された形になっています。

{
	"mcpServers": {
		"3minapi": {
			"type": "http",
			"url": "https://3minapi.com/api/mcp",
			"headers": { "x-api-key": "tm_mcp_..." }
		}
	}
}

ステップ4 — ツールのMCP設定ファイルに貼り付け

コピーしたスニペットを、使用中のツールのMCP設定ファイルに追加します。ツールごとの設定ファイル位置は各ツールの公式ドキュメントを参照してください。

  • Claude Code: プロジェクトルートの .mcp.json またはユーザー設定
  • Cursor: 設定 → MCP Servers
  • その他のMCP対応ツールも同じJSON形式を使用します

設定を保存してツールを再起動すると、3minapi ツールが認識されます。

ステップ5 — キー管理

その後のキー再発行・削除は同じ画面から可能です。

  • キー再発行 — 新しいキーを発行すると同時に 既存のキーは即座に無効化 されます。紛失や漏洩の疑いがある場合に使用してください。再発行後は、すべてのツールの設定ファイルでキーを新しい値に置き換える必要があります。
  • キー削除 — キーを完全に削除します。削除後はどのツールからも本人アカウントにアクセスできなくなります。

使い方の例

下記のような自然言語のプロンプトがうまく動きます。

  • "私のAPIエンドポイント一覧を見せて"
  • "顧客問い合わせを受けるエンドポイントを作って。名前、メール、メッセージのフィールド付きで。"
  • "昨日失敗した呼び出しを5件まとめて"
  • "今月の使用量を昨日まで合算して教えて"
  • "協力者chris@example.comをuser-signupエンドポイントに招待して"

作成・更新・デプロイが必要なリクエストは、AIがユーザーにもう一度確認してから進めます。意図と違うリクエストが通らないように、回答をよく確認してください。

よくあるつまずき

  • APIキーの全体を見ずに画面を閉じてしまいました

    セキュリティ上、キー全体は発行時に一度だけ表示されます。再表示できないのが正常です。CLI / IDE タブで キー再発行 をすれば新しいキーを作成できます（既存のキーは即座に無効化されるので、使用中のツールの設定も合わせて置き換えてください）。

  • ツールにキーを入れたのに認識されません

    ツールを 完全に再起動 する必要があります。設定ファイルを保存しただけではMCPサーバーが新しく接続されない場合があります。JSONにタイプミスがあるとツールが黙って無視することがあるので、形式ももう一度確認してください。

  • 他人のデータが混ざって見えるのではないかと心配です

    心配ありません。MCP APIキーは発行した本人のアカウントに紐づいているので、すべてのツールは 本人アカウントのリソースにのみ アクセスします。他のユーザーのエンドポイント・ログ・アーカイブは絶対に見えません。

  • AIがエンドポイントを削除しました

    削除できません。削除のような破壊的操作はMCPから除外されているため、AIがいくら試しても、データは消えません。本当に削除したい場合は、https://3minapi.com に直接ログインして実行してください。

  • tm_test_*、tm_live_* とはどう違いますか？

    全く違うキーです。tm_test_*（サンドボックス）・tm_live_*（本番）は外部から本人の APIエンドポイントを呼び出す ときに使う コラボレーションキー で、tm_mcp_* はAIツールが本人の 3Min APIアカウント にアクセスするときに使うキーです。混在させると認証に失敗します。

前へ
Claude連携