メニュー経路: 設定 > AI連携 > Claude

Claude連携

概要

AI連携は、Claudeのような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キー方式でローカル設定ファイルにキーを置いて使います。このページでは Claudeのカスタムコネクタで接続する方法を案内します。

できること

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_callDELETE は、ユーザーが定義したエンドポイントのビジネスロジック(例:注文キャンセルAPI)を呼び出す動作です。エンドポイント自体を削除する動作ではありません。

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

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

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

連携方法

Claudeは OAuth方式 で接続されます。カスタムコネクタにサーバーURLだけ登録すれば、その後の認証は3Min APIアカウントでのログインで完了します。APIキーを直接入力することはありません。

ステップ1 — Claude設定に進む

Claude(https://claude.ai)を開き、右上のアカウントメニューから 設定 に移動します。

ステップ2 — コネクタセクションに移動

Claude設定の左メニューにあるコネクタセクション

設定画面の左メニューで コネクタ セクションを選択します。

ステップ3 — カスタムコネクタを追加

名前とサーバーURLを入力するカスタムコネクタ追加フォーム

カスタムコネクタを追加 ボタンを押して、下記情報を入力します。

  • コネクタ名: 3minapi(好きな名前で自由に)

  • サーバーURL:

    https://3minapi.com/api/mcp
    

ステップ4 — 接続後、OAuthでログイン

コネクタが追加され、接続ボタンが表示された画面

接続 ボタンを押すと、3Min APIのログイン画面が新しいウィンドウで開きます。普段使っている3Min APIアカウントでログインすると、自動的に権限が付与されます。

ステップ5 — 新しいチャットで使う

新しいチャットを開いてすぐに使ってみましょう。

Claude 無料プラン はカスタムコネクタを 1個 まで登録できます。Pro以上 は無制限です。

使い方の例

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

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

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


よくあるつまずき

  • 接続 を押したのにツールが出てきません

    Claudeのコネクタはキャッシュの問題でツール一覧が即座に更新されないことがあります。コネクタを一度切断してから再接続 してみてください。新しいチャットでツール一覧が正常に表示されます。

  • 無料プランなのにコネクタを追加できません

    すでに別のカスタムコネクタを1個登録している可能性があります。無料プランは1個までなので、既存のコネクタを削除するか、Pro以上のプランにアップグレードしてください。

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

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

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

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

  • Claude Code(ターミナル)でも同じ方法で接続しますか?

    いいえ。Claude ウェブ・デスクトップ はOAuth方式のカスタムコネクタを使い、Claude Code(CLI)・Cursorのようなローカルツールは APIキー方式を使います。後者は MCP連携 (CLI / IDE) ガイドを参照してください。