Перейти к содержимому
Agentum Cloud для разработчиков

List Mcp

GET
/v1/deployments/{deployment_id}/mcp
curl --request GET \
  --url https://api.cloud.agentums.ru/v1/deployments/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/mcp \
  --header 'Authorization: Bearer <token>'

Чем агент умеет пользоваться сверх наших собственных инструментов.

Наша собственная дверь (agentum) в этот список НЕ входит: она не подключение, а часть агента, и предложив её выключить, мы предложили бы сломать доступ к файлам владельца.

Authorizations

Заголовок раздела «Authorizations»

Parameters

Заголовок раздела «Parameters»

Path Parameters

Заголовок раздела «Path Parameters»
deployment_id
required
Deployment Id
string format: uuid

Responses

Заголовок раздела «Responses»

200

Заголовок раздела «200»

Successful Response

Media typeapplication/json
McpListOut

Что подключено и что ещё можно подключить — одним ответом.

Каталог и подключения вместе, а не двумя запросами: экран показывает их одним списком, и два запроса означали бы промежуточное состояние, в котором галочки уже есть, а отметок «подключено» ещё нет.

object
catalog
Catalog
Array<object>
McpCatalogEntryOut

Готовое подключение из нашего каталога — то, что включается одной галочкой.

object
auth
required
Auth
string
code
required
Code
string
connected
Connected
boolean
docs_url
Docs Url
string
""
hint
required
Hint
string
title
required
Title
string
tools
Tools
Array<string>
verified_at
Verified At
string
""
custom_enabled
Custom Enabled
boolean
default: true
external_paused
External Paused
boolean
items
Items
Array<object>
McpServerOut

Подключение, заведённое этому развёртыванию.

Ни адреса заголовков, ни самих заголовков здесь нет. Наружу уходит только подсказка вида Authorization: …abcd: заголовок чужого сервера — это, как правило, ключ человека к постороннему продукту, и отдавать его обратно незачем — он уже у того, кто его ввёл.

object
catalog_code
Catalog Code
string
""
consent_expires_at
Any of:
string format: date-time
consent_scope
Consent Scope
object
key
additional properties
any
consent_status
Consent Status
string
default: required
enabled
Enabled
boolean
default: true
header_hint
Header Hint
string
""
id
required
Id
string format: uuid
key
required
Key
string
pause_reason
Pause Reason
string
""
title
required
Title
string
tool_include
Tool Include
Array<string>
transport
required
Transport
string
url
required
Url
string
limit
Limit
integer
0
Example
{
  "catalog": [
    {
      "connected": false,
      "docs_url": "",
      "verified_at": ""
    }
  ],
  "custom_enabled": true,
  "external_paused": false,
  "items": [
    {
      "catalog_code": "",
      "consent_status": "required",
      "enabled": true,
      "header_hint": "",
      "pause_reason": ""
    }
  ],
  "limit": 0
}

422

Заголовок раздела «422»

Validation Error

Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
ctx
Context
object
input
Input
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
Examplegenerated
{
  "detail": [
    {
      "ctx": {},
      "input": "example",
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example"
    }
  ]
}