logo
Development
検索
MCP ツールリストの更新

MCP ツールリストの更新

指定した MCP Server の tools を再取得し、actions を更新できます。

本インターフェースを使用して、指定した MCP Server の tools を再取得し、actions を更新できます。

リクエストメソッド

POST

リクエストURL

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

リクエスト認証

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

リクエスト

リクエスト例

curl -X POST 'https://api.${endpoint}/v1/org/mcp/refresh' \ -H 'Authorization: Basic ${BASIC_TOKEN}' \ -H 'Content-Type: application/json' \ -d '{ "org_id": "p-xxxx", "id": "mcp-xxxx" }'
                      
                      curl -X POST 'https://api.${endpoint}/v1/org/mcp/refresh' \
  -H 'Authorization: Basic ${BASIC_TOKEN}' \
  -H 'Content-Type: application/json' \
  -d '{
    "org_id": "p-xxxx",
    "id": "mcp-xxxx"
  }'

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

リクエストヘッダー

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

リクエストパラメータ(Body Parameters)

パラメータ タイプ 説明 required
org_id String 組織 ID。 true
id String MCP ID。 true

レスポンス

レスポンス例

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

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

成功時のレスポンス

フィールド タイプ 説明
mcp_id String MCP ID。
action_count Integer 更新後の Action の数。
available Boolean MCP が利用可能かどうか。

エラー時のレスポンス

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

ステータスコード

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