​
Обзор

Агентика предоставляет MCP (Model Context Protocol)-сервер, который позволяет AI-ассистентам вроде Codex, Claude Code, Claude Desktop и Cursor обращаться к вашему рабочему пространству и документации. После подключения ассистент может выводить список ваших агентов, получать их определения и искать по документации Агентики от вашего имени.

​
Предварительные требования

  • API-ключ Агентики. Сгенерируйте его на /api-keys (или http://localhost:3010/api-keys для self-hosted). См. API-ключи.
  • Ваш MCP-эндпоинт Агентики:
    • Хостинг: https://app.agentika.ai/api/v1/mcp/
    • Self-hosted: <YOUR_BACKEND_URL>/api/v1/mcp/
Эндпоинт также отображается в Platform Settings → MCP Server в интерфейсе Агентики.
Если вы развернули Агентику на удаленном сервере с помощью setup_remote.sh, ваш эндпоинт обслуживается с самоподписанным SSL-сертификатом. Claude Code откажется устанавливать MCP-соединение с ним, если вы не запустите CLI с отключенной проверкой TLS:
Это требуется только для самоподписанных сертификатов. Если вы настроили собственный домен с сертификатами Let’s Encrypt через Certbot, дополнительный флаг не нужен.

​
Claude Code

Зарегистрируйте Агентику как MCP-сервер в Claude Code CLI:
Замените YOUR_API_KEY на сгенерированный вами ключ. Для self-hosted развертываний подставьте вместо URL адрес своего бэкенда. Проверьте, что сервер подключен:

​
Codex

Откройте конфигурационный файл Codex (~/.codex/config.toml) и добавьте MCP-сервер agentika:
Замените YOUR_API_KEY на сгенерированный вами ключ. Для self-hosted развертываний замените URL на адрес MCP-эндпоинта вашего бэкенда. Если вы предпочитаете не хранить API-ключ в config.toml, поместите его в переменную окружения:
Затем задайте API-ключ перед запуском Codex:
Проверьте, что сервер зарегистрирован:

​
Claude Desktop

Откройте конфигурационный файл Claude Desktop (claude_desktop_config.json) и добавьте запись agentika в mcpServers:
После сохранения перезапустите Claude Desktop. Инструменты Агентики должны появиться в выборе инструментов.

​
Cursor и другие MCP-клиенты

Любой MCP-клиент, поддерживающий транспорт Streamable HTTP, может подключиться с тем же URL и заголовком. Вставьте конфигурацию выше в файл настроек MCP вашего клиента и замените YOUR_API_KEY.

​
Примеры промптов

После подключения MCP-сервера вы можете управлять Агентикой из своего coding-агента на обычном английском языке. Вот несколько промптов, которые стоит попробовать: Изучите свое рабочее пространство
  • «Покажи список моих агентов в Агентике».
  • «Покажи определение агента Lead Qualifier».
  • «Какие учётные данные и инструменты настроены в моем рабочем пространстве Агентики?»
  • «Покажи записи звонков моего последнего агента».
Отредактируйте агента
  • «В моем агенте Lead Qualifier добавь новый agent node после приветствия, который спрашивает у абонента его бюджет, а затем ведет к существующему узлу квалификации».
  • «Добавь в Support Bot end-call node, который срабатывает, когда пользователь говорит, что закончил, с вежливым прощальным промптом».
  • «Переименуй узел intro в Lead Qualifier в greeting и обнови все edges, которые на него ссылаются».
  • «Смени LLM-модель на всех agent node в Support Bot на gpt-4o-mini».
Изучите платформу
  • «Найди в документации Агентики, как настроить TURN-сервер».
  • «Какие типы узлов поддерживает Агентика и какие поля принимает узел knowledge_base?»
  • «Как развернуть Агентику на собственном домене с HTTPS?»
Правки агента сохраняются как новая версия-черновик — опубликованный агент продолжает обрабатывать звонки, пока вы явно не опубликуете черновик из интерфейса Агентики.
API-ключ определяет, какое рабочее пространство видит ассистент. Относитесь к нему как к любым другим учётным данным — не публикуйте его в системе контроля версий и не вставляйте в общие чаты.