MCP: продвинутая настройка

Для разработчиков: Model Context Protocol, свой MCP-сервер, регистрация и выдача доступа.

Model Context Protocol — открытый стандарт от Anthropic для подключения LLM к внешним инструментам. AGONTS под капотом использует MCP для всех инструментов агента: SQL, RAG, Bitrix24, 1С, файлы, поиск — это всё MCP-сервера.

Когда писать свой MCP

Корпоративный API без публичной OpenAPI-схемы
Нестандартная авторизация (mTLS, signed JWT, custom)
Нужен control над тем, как именно AI видит ваши данные (фильтры, маскинг, RBAC)
Хотите переиспользовать тот же сервер из других LLM-клиентов (Claude Desktop, IDE)

Архитектура

[AGONTS]  ←→  [your MCP server]  ←→  [your API / DB / system]

AGONTS вызывает MCP-сервер через JSON-RPC поверх HTTP или stdio. MCP-сервер сам решает, как достать данные.

Минимальный сервер

Любой язык. Пример на TypeScript с @modelcontextprotocol/sdk:

import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
import { z } from 'zod';

const server = new McpServer({ name: 'my-crm', version: '1.0.0' });

server.tool(
  'find_customer',
  { phone: z.string().describe('Телефон в формате +7...') },
  async ({ phone }) => {
    const res = await fetch(`https://my-api.local/customers?phone=${phone}`, {
      headers: { Authorization: `Bearer ${process.env.MY_API_TOKEN}` },
    });
    return { content: [{ type: 'text', text: await res.text() }] };
  },
);

await server.connect(new StdioServerTransport());

Подключение к AGONTS

Хостинг: либо ваша сеть с туннелем (Cloudflare Tunnel / ngrok), либо self-hosted на том же сервере, что и AGONTS.
AGONTS UI: Подключения → «Свой MCP», вводите URL/команду + секрет.
AGONTS вызывает tools/list и подтягивает все ваши инструменты.
Привязываете к нужному AI-сотруднику в config.mcpServers.

Безопасность

Секреты хранятся зашифрованными (AES-256-GCM, ключ MCP_SECRETS_KEY). Никаких токенов в логах, маскинг в UI. Сервер вызывается только в контексте workspace владельца карточки — cross-tenant изоляция гарантирована.

Хорошие практики

Описывайте инструменты максимально специфично: find_customer_by_phone вместо query_database. AI выбирает лучше, когда видит чёткую цель.
Возвращайте структурированный JSON, не свободный текст. AI цитирует поля.
Ставьте rate limit на стороне сервера. AI может заспамить вызовами.
Тест: запустите npx @modelcontextprotocol/inspector локально перед регистрацией в AGONTS.