# Openapi®

Подключает API openapi.com к агенту: официальные документы компаний, PEC, SMS, геокодинг и данные по автомобилям. Пригодится, когда нужны итальянские реестры прямо из чата.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 22
- Автор: openapi
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/openapi/mcp-server
- Обновлён: 2026-10-16
- HTML: https://affpapa.org/nevibecode/mcp/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 или новее.

## Требования
- Нужно: Python и uv (команды через uvx)
- Удалённый сервер: `https://mcp.openapi.com/`

## Установка

### Claude Code (родная платформа)

**Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http openapi https://mcp.openapi.com/
```

### Codex

**Командой платформы: удалённый сервер**
```bash
codex mcp add openapi --url https://mcp.openapi.com/
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "openapi": {
            "url": "https://mcp.openapi.com/"
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "openapi": {
            "type": "http",
            "url": "https://mcp.openapi.com/"
        }
    }
}
```

### Gemini CLI

**Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http openapi https://mcp.openapi.com/
```

## Когда брать
- получить официальные документы итальянской компании по её реквизитам
- отправить SMS из сценария агента
- проверить PEC-адрес контрагента
- получить координаты по адресу через геокодинг
- подтянуть данные автомобиля по номеру

## Примеры запросов агенту
- Найди в реестре итальянскую компанию по названию и покажи её официальные документы
- Отправь SMS на номер из заявки с кодом подтверждения
- Определи координаты адреса доставки в Милане

## Похожие
- [MCP Toolbox for Databases](https://affpapa.org/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP-сервер · ★ 16717
- [PostHog MCP Server](https://affpapa.org/nevibecode/mcp/posthog-mcp-server.md) — MCP-сервер · ★ 40409
- [OpenWork MCP Gateway](https://affpapa.org/nevibecode/mcp/openwork-mcp-gateway.md) — MCP-сервер · ★ 24242
- [Keploy](https://affpapa.org/nevibecode/mcp/keploy.md) — MCP-сервер · ★ 18727
- [Nhost](https://affpapa.org/nevibecode/mcp/nhost.md) — MCP-сервер · ★ 9366
- [basebalance.cloud — x402 RPC & MCP gateway](https://affpapa.org/nevibecode/mcp/basebalancecloud-x402-rpc-mcp-gateway.md) — MCP-сервер · ★ 7506

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md