3Min API — MCPサーバーガイド

3Min API MCPサーバーの技術ドキュメントです。利用可能なツール、認証方式、セットアップ方法、使用例をご案内します。

1. サーバー説明

3Min APIは、バックエンド開発能力を持たない中小企業向けのAPIリレーサービスです。Schema-as-Data設計を採用し、APIスキーマを構造化データとして保存するため、顧客ごとのデータベース設定が不要です。

MCPサーバーにより、ClaudeなどのAIアシスタントがAPIエンドポイントの管理、テストリクエストの送信、ログ検索、分析の閲覧、コラボレーターの管理を自然言語の会話で行えます。

2. 機能

利用可能なツール

help — あらゆるトピックのガイドとサービスリファレンスを提供
endpoints — APIエンドポイントの作成、設定、更新、デプロイ
api_call — API Gatewayを通じたHTTPリクエスト（POST、GET、PUT、DELETE）の送信
logs — テキスト、日付範囲、レコードIDによるログ検索（アーカイブペイロード対応）
stats — エンドポイントごとの月間利用分析と日別詳細の表示
collaborators — コラボレーションキー、権限、招待の管理
subscription — プラン情報、利用数、請求情報の確認
archives — アーカイブデータファイルの一覧とダウンロード（CLI専用）

ユースケース

コードを書かずにAPIエンドポイントを素早く設定・テスト
ログと統計を通じたAPI利用状況のモニタリングと問題調査
コラボレーションキーの作成と招待によるチームアクセス管理

3. セットアップ方法

MCPサーバーURL:

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

Claude.ai / Claude Desktop

設定 → コネクタを開きます
「カスタムコネクタを追加」をクリックします
上記のMCPサーバーURLを入力します
プロンプトに従ってOAuthサインインを完了します

APIキーは不要です — OAuthにより自動的に認証されます。

Claude Code / CLI

ダッシュボードからMCP APIキーを生成します（設定 → MCP連携）
MCPクライアントにサーバー設定を追加します：

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

YOUR_MCP_API_KEYをステップ1で生成したキーに置き換えてください。

4. 認証

MCPサーバーは、ブラウザベースのクライアント向けのOAuth 2.1 + PKCE（S256）とCLIツール向けのAPIキー認証をサポートしています。

OAuth 2.1（Claude.ai / Desktop）

完全自動化 — ユーザーはブラウザでサインインするだけです。サーバーが実装する標準：

RFC 8414 — Authorization Server Metadata Discovery
RFC 7591 — Dynamic Client Registration
RFC 9728 — Protected Resource Metadata
PKCE (S256) — Proof Key for Code Exchange

APIキー（CLI）

MCP APIキーをx-api-keyヘッダーで渡すか、MCPクライアント設定の環境変数として設定します。

5. 使用例

例1：サンドボックスAPIエンドポイントの作成

"3minapiで、オンライン注文を受け付けたいです。顧客名、注文金額、メールアドレスが必要で、名前とメールで検索できるようにしたいです。"

Action: Claudeがendpoints(action: "create", endpoint_name: "orders", field_definitions: [...])を呼び出します

Result: サンドボックスフィールド定義を持つ新しいエンドポイントが作成されます。レスポンスにはエンドポイントID、サンドボックス/本番APIキーを含むデフォルトコラボレーションキー、API呼び出しを受信するエンドポイントURLが含まれます。

例2：サンドボックスAPIテスト呼び出し

"先ほど作成したエンドポイントにJohn Doeからの$150のテスト注文を送ってください"

Action: Claudeがapi_call(endpoint_id: "...", environment: "sandbox", method: "POST", body: [fields])を呼び出し、次にlogs(endpoint_id: "...", environment: "sandbox")で結果を確認します。

Result: API Gatewayがリクエストを非同期で処理します（202 Accepted）。その後、Claudeがログエントリを取得し、すべてのフィールド値が保存されてレコードが正常に作成されたことを確認します。

例3：サンドボックスログ検索

"先週のJohnに関する注文をすべて表示してください"

Action: Claudeがlogs(endpoint_id: "...", environment: "sandbox", search_text: "john", start_date: "...", end_date: "...")を呼び出します

Result: レコードID、HTTPメソッド、ステータスコード、タイムスタンプ、ペイロードデータを含むログエントリが返されます。結果はページネーション（1ページ10件）され、合計件数が表示されます。

6. プライバシーポリシー

完全なプライバシーポリシーは以下でご確認いただけます：

https://3minapi.com/ja/privacy

7. サポート

ご質問、問題、フィードバックがある場合：

メール：contact@3minapi.com