MCP の作成

指定した組織配下に MCP を作成し、MCP Server が公開する tools を取得できます。

本インターフェースを使用して、指定した組織配下に MCP を作成し、MCP Server が公開する tools を取得できます。

リクエストメソッド

POST

リクエストURL

https://api.${endpoint}/v1/org/mcp/create

リクエスト認証

アカウントレベルの DevKey / DevSecret による Basic 認証を使用します。呼び出しアカウントに組織 MCP の作成権限が必要です。

リクエスト

リクエスト例

curl -X POST 'https://api.${endpoint}/v1/org/mcp/create' \ -H 'Authorization: Basic ${BASIC_TOKEN}' \ -H 'Content-Type: application/json' \ -d '{ "org_id": "p-xxxx", "name": "crm-mcp", "display_name": "CRM MCP", "description": "CRM MCP server", "logo": "https://cdn.example.com/mcp.png", "url": "https://mcp.example.com/sse", "show_request": true, "mcp_transport_type": "SSE", "headers": [{"key": "Authorization", "value": "Bearer token"}], "queries": [{"key": "tenant", "value": "demo"}] }'

                      
                      curl -X POST 'https://api.${endpoint}/v1/org/mcp/create' \
  -H 'Authorization: Basic ${BASIC_TOKEN}' \
  -H 'Content-Type: application/json' \
  -d '{
    "org_id": "p-xxxx",
    "name": "crm-mcp",
    "display_name": "CRM MCP",
    "description": "CRM MCP server",
    "logo": "https://cdn.example.com/mcp.png",
    "url": "https://mcp.example.com/sse",
    "show_request": true,
    "mcp_transport_type": "SSE",
    "headers": [{"key": "Authorization", "value": "Bearer token"}],
    "queries": [{"key": "tenant", "value": "demo"}]
  }'

このコードブロックをポップアップで表示

リクエストヘッダー

フィールド	タイプ	説明
Authorization	Basic ${BASIC_TOKEN}	`DevKey:DevSecret` を Base64 エンコードした Basic Token を使用します。
Content-Type	application/json	リクエストボディの形式。

リクエストパラメータ（Body Parameters）

パラメータ	タイプ	説明	required
org_id	String	組織 ID。	true
name	String	MCP 名称、最大 20 文字。	true
display_name	String	MCP 表示名称、最大 50 文字。	false
description	String	MCP 説明、最大 100 文字。	true
logo	String	MCP アイコン URL。	true
url	String	MCP Server URL。公開された `http/https` アドレスである必要があります。	true
show_request	Boolean	呼び出し過程でリクエスト内容を表示するかどうか。	true
mcp_transport_type	String	MCP 転送タイプ。`SSE`、`STREAMABLE_HTTP` をサポート。	true
headers	Object[]	MCP リクエストヘッダー、最大 10 件。各項目に `key`、`value` を含みます。	false
queries	Object[]	MCP クエリパラメータ、最大 30 件。各項目に `key`、`value` を含みます。	false

レスポンス

レスポンス例

{ "code": 0, "message": "OK", "data": { "mcp_id": "mcp-xxxx", "available": true, "action_count": 3 } }

                      
                      {
  "code": 0,
  "message": "OK",
  "data": {
    "mcp_id": "mcp-xxxx",
    "available": true,
    "action_count": 3
  }
}

このコードブロックをポップアップで表示

成功時のレスポンス

フィールド	タイプ	説明
mcp_id	String	新規作成した MCP ID。
available	Boolean	MCP が利用可能かどうか。
action_count	Integer	取得した Action の数。

エラー時のレスポンス

フィールド	タイプ	説明
code	Integer	エラーコード。
message	String	エラー詳細。

ステータスコード

ステータスコード	説明
200	成功
400	パラメータエラー
401	未認証
403	権限不足
429	リクエストが頻繁すぎます
500	サーバーエラー