Add Mcp

POST

/v1/deployments/{deployment_id}/mcp

curl --request POST \
  --url https://api.cloud.agentums.ru/v1/deployments/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/mcp \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "catalog_code": "", "headers": { "additionalProperty": "example" }, "key": "", "title": "", "tool_include": [ "example" ], "transport": "", "url": "" }'

• Прод

Подключить сервер — из каталога по коду либо свой по адресу.

Отдельного «применить» нет и не нужно: правка расходится с отпечатком настроек на машине, и раннер пересоздаёт контейнер в течение минуты сам.

Authorizations

• bearerAuth

Parameters

Path Parameters

deployment_id

required

Deployment Id

string format: uuid

Request Body^required

Media typeapplication/json

McpServerIn

Новое подключение: либо код из каталога, либо свой адрес.

Два способа одним телом, потому что результат один — строка в списке серверов агента. Разводить их по маршрутам значило бы удваивать и проверки, и клиентов.

object

catalog_code

Catalog Code

string

""

headers

Headers

object

key

additional properties

string

key

Key

string

""

title

Title

string

""

tool_include

Tool Include

Array<string>

transport

Transport

string

""

url

Url

string

""

Responses

201

Successful Response

Media typeapplication/json

McpServerOut

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

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

object

catalog_code

Catalog Code

string

""

consent_expires_at

Any of:

string

string format: date-time

null

null

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

Example

{
  "catalog_code": "",
  "consent_status": "required",
  "enabled": true,
  "header_hint": "",
  "pause_reason": ""
}

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

Example^generated

{
  "detail": [
    {
      "ctx": {},
      "input": "example",
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example"
    }
  ]
}