Openapi® — MCP-сервер для Claude Code: данные итальянских компаний
Подключает API openapi.com к агенту: официальные документы компаний, PEC, SMS, геокодинг и данные по автомобилям. Пригодится, когда нужны итальянские реестры прямо из чата.
claude mcp add --transport http openapi https://mcp.openapi.com/Что делает Openapi®
Сервер работает как прокси к API openapi.com и передаёт Bearer-токен клиента дальше, сам его не хранит. Инструменты разложены по модулям в каталоге apis, регистрация и вызовы API собраны в mcp_core.py. Часть методов отдаёт бинарные документы, поэтому серверу нужно хранилище: по умолчанию локальный путь ./openapi_storage, можно переключить на GCS или S3.
Есть два способа использования. Готовый сервер запускается командой uvx openapi-mcp-sdk server и слушает http://localhost:8080, есть вариант через Docker и compose.yml. Второй путь — импортировать openapi_mcp_sdk в свой проект и обернуть нужные методы своей логикой. Асинхронные ответы приходят на колбэк $MCP_BASE_URL/callbacks, а результаты можно складывать в Redis или Memcached, если инстансов несколько.
Токен openapi.com клиент передаёт сам, без него запросы к API не пройдут. Для облачного хранилища понадобится имя бакета, для S3 ещё и регион. Пакет требует Python 3.13 или новее.
Какие задачи решает
- получить официальные документы итальянской компании по её реквизитам
- отправить SMS из сценария агента
- проверить PEC-адрес контрагента
- получить координаты по адресу через геокодинг
- подтянуть данные автомобиля по номеру
Примеры запросов агенту
- Найди в реестре итальянскую компанию по названию и покажи её официальные документы
- Отправь SMS на номер из заявки с кодом подтверждения
- Определи координаты адреса доставки в Милане
Как установить Openapi®
Командой платформы: удалённый сервер
claude mcp add --transport http openapi https://mcp.openapi.com/Командой платформы: удалённый сервер
codex mcp add openapi --url https://mcp.openapi.com/Файл настроек
{
"mcpServers": {
"openapi": {
"url": "https://mcp.openapi.com/"
}
}
}Файл настроек
{
"servers": {
"openapi": {
"type": "http",
"url": "https://mcp.openapi.com/"
}
}
}Командой платформы: удалённый сервер
gemini mcp add -t http openapi https://mcp.openapi.com/По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Openapi®
Как установить Openapi® в Claude Code?
Выполните claude mcp add --transport http openapi https://mcp.openapi.com/. Сервер подключится как HTTP MCP, локальный запуск не нужен.
Что делает Openapi®?
Даёт агенту доступ к API openapi.com: реестр итальянских компаний, PEC, SMS, автомобили, геокодинг. Токен клиента передаётся в API как есть.
Можно ли поднять сервер у себя вместо удалённого?
Да, пакет openapi-mcp-sdk ставится из PyPI и запускается командой openapi-mcp-sdk server на порту 8080. Нужен Python 3.13 или новее, а для документов — хранилище: локальный каталог, GCS или S3.
