Что получится на выходе, когда создан MCP-сервер
Вы получите работающий MCP-сервер в своём аккаунте в Allokai, его постоянный адрес и ключ доступа. Внешняя программа подключается по этому адресу и вызывает инструменты сервера: каждый инструмент описан именем, пояснением и схемой аргументов.
| Что | Как выглядит |
|---|---|
| Сервер | Приложение в вашем аккаунте; каждое приложение в Allokai — MCP-сервер |
| Адрес | Постоянная ссылка |
| Ключ доступа | Его создаёт агент, внешняя программа предъявляет его при вызове; ключ можно отозвать |
| Инструменты | Действия, которые умеет сервер: имя, описание, аргументы |
| Версии | Новая версия заменяет старую, старую можно вернуть |
Как создать MCP-сервер: три шага
- Опишите задачу. Скажите, с каким сервисом сервер работает, какие действия нужны и что принимает каждое.
- Агент пишет и проверяет. Он пишет код, запускает сервер в облаке и вызывает инструменты с пробными аргументами. Ответы вы видите в чате.
- Вы получаете адрес и ключ. Дальше правите сервер словами: «добавь инструмент», «верни дату в другом формате».
Первую проверку лучше провести на данных, ответ которых вы знаете заранее: так ошибка заметна сразу.
Пример: сервер над API вашего сервиса
Допустим, у вас есть CRM с API. Вы просите два инструмента: найти заказ по номеру и выгрузить отчёт за период. Агент описывает их так:
| Инструмент | Аргументы | Что возвращает |
|---|---|---|
find_order |
order_id — номер заказа, строка |
Статус, сумму и дату заказа |
export_report |
date_from, date_to — даты |
Файл xlsx с заказами за период |
Токен CRM вы вводите в защищённую форму. Он хранится в сейфе в зашифрованном виде, и сервер использует его для обращения к CRM. Запрос «покажи заказ 1042» превращается в вызов find_order с аргументом order_id, равным 1042. Устройство такого вызова разобрано в статье что такое MCP-сервер.
Что внутри MCP-сервера в Allokai
- Инструменты и схема аргументов. Каждый инструмент описан именем, пояснением и схемой аргументов; по ним модель понимает, когда инструмент нужен и что ему передать.
- Секреты. Токены и пароли лежат в сейфе в зашифрованном виде.
- Входящий HTTP и вебхуки. Сервер принимает события из других сервисов и данные с форм.
- Расписание и фоновая работа. Они идут при закрытой вкладке.
- Страница. Если нужен интерфейс, у приложения есть страница; о таких приложениях написано в разделе создать приложение с помощью ИИ.
Задачи по расписанию агент ставит самым дешёвым способом: обычно это скрипт без модели, и короткий запуск стоит сотые доли кредита. Постоянно включённое приложение тратит кредиты всё время, пока включено. Ненужное выключите словами в чате.
Где живёт сервер после создания
Сервер размещается в облаке Allokai сразу, как только агент его запустил. Свой компьютер, хостинг и перезапуск вручную не нужны. Работа по расписанию и фоновые задачи идут при закрытой вкладке; гарантий сроков и доступности Allokai не даёт.
Внешняя программа вызывает сервер по ключу доступа. Если ключ попал не в те руки, отзовите его: вызовы по этому ключу перестанут проходить.
Как подключить сервер к внешней программе
- Возьмите у агента адрес сервера и ключ доступа.
- В программе, которая умеет подключаться к удалённым MCP-серверам, добавьте сервер: укажите адрес и ключ.
- Программа запросит список инструментов (в протоколе это
tools/list) и покажет его модели. Когда модель выберет инструмент, программа вызовет его запросомtools/callс аргументами по схеме.
Протокол советует показывать вызов человеку и спрашивать подтверждение, но как это сделано, решает сама программа. Умеет ли ваша программа работать с удалённым сервером и ключом, смотрите в её документации. Совместимость с конкретными клиентами мы не проверяли.
Писать самому или попросить агента
Если вы программист, можно взять официальный SDK. На 9 октября 2026 на сайте протокола перечислены SDK для TypeScript, Python, C#, Go, Rust и Ruby (первый уровень поддержки), Java (второй уровень), а также Swift, PHP и Kotlin (третий). Для Python есть и FastMCP — фреймворк, который превращает обычные функции в инструменты:
from fastmcp import FastMCP
mcp = FastMCP("Orders")
@mcp.tool
def find_order(order_id: str) -> str:
"""Return the status of an order."""
... # здесь вызов вашего API
if __name__ == "__main__":
mcp.run()
| SDK или FastMCP | Агент в Allokai | |
|---|---|---|
| Что нужно уметь | Программировать на выбранном языке | Описать задачу словами |
| Где запускается | На вашем компьютере или в вашем облаке | В облаке Allokai, сразу |
| Размещение и обновление | На вас | Новая версия заменяет старую, ссылка остаётся |
| Нестандартные случаи | Полный контроль над кодом | Хорошо описанная задача; сложную логику проще написать самому |
Если нужен полный контроль над кодом, берите SDK: так проще, чем объяснять агенту каждую деталь. Если нужен рабочий сервер без разработки и хостинга, подойдёт чат.
Ограничения
Вызовы инструментов требуют ключа доступа, публичного каталога серверов у Allokai нет. Открытые файлы страницы не следует считать приватными; рабочие данные сервер должен выдавать только после проверки доступа. Готовых серверов «из коробки» тоже нет: подключение к сервису агент пишет под вашу задачу, по его документации.
Агент пишет код, но не знает ваши данные. Результат нужно смотреть: вызовите инструменты с реальными аргументами и сверьте ответы с тем, что видите в самом сервисе. Если для подключения нужен токен или действие человека в чужом сервисе, агент скажет об этом. Примеры серверов над конкретными системами: MCP для 1С и MCP для Ozon и Wildberries.