Cookbook
Agents & skills · for AI agents

Подключение собственного MCP-сервера

Зарегистрируйте удалённый MCP-сервер, чтобы ваши агенты могли вызывать его инструменты — через консоль или REST.

MCP tools:list_mcp_serverslist_toolsupdate_agent

Подключайте свои инструменты: зарегистрируйте удалённый MCP-сервер, и его инструменты станут доступны для привязки к вашим агентам. Инструмента «создать MCP-сервер» намеренно нет — регистрация сервера означает доверие ему к выполнению запросов в рамках вашего арендатора, поэтому это осознанное действие в консоли (или REST-вызов), а не то, что агент делает самостоятельно.

1. Регистрация сервера

В консоли: Tools / MCP → Add MCP server — укажите имя, выберите транспорт (Streamable HTTP или SSE), а также URL и любые заголовки аутентификации.

Или через REST, используя ключ вашего арендатора ($BASE = https://api.agent4.io/v1):

curl -X POST $BASE/mcp-servers -H "X-API-Key: $KEY" -H 'Content-Type: application/json' \
  -d '{"name":"my-tools","transport":"streamable_http",
       "config":{"url":"https://tools.example.com/mcp","headers":{"Authorization":"Bearer …"}}}'

Принимаются только удалённые транспорты. stdio (локальные команды) отклоняется — сервер работает на платформе, а не на вашем компьютере, поэтому локальная команда была бы для вас бесполезной и представляла бы риск выполнения кода.

2. Просмотр доступных инструментов

list_mcp_servers()   # the MCP servers registered on your tenant
list_tools()         # every tool you can attach to an agent, including the ones from your servers

3. Привязка инструментов к агенту

update_agent(name="Support", add_tools=["…"])   # incremental; use tool names exactly as list_tools() reports them

Теперь агент может вызывать эти инструменты во время разговора. Держите набор инструментов сфокусированным — несколько релевантных инструментов лучше, чем большой набор (см. Принципы проектирования).