Openapi.com MCP-сервер для Gemini CLI

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Openapi.com Company, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Openapi.com Company + Gemini

Данные итальянских и зарубежных компаний из Openapi.com по номеру НДС или налоговому коду: профиль компании трёх уровней, PEC, код SDI, адрес, участники, заинтересованные лица, конечные бенефициары, проверка прекращения деятельности и НДС-группы, органы государственного управления, split payment, поиск компаний, проверка в EU VIES и запросы по всему миру. Только чтение; Openapi.com тарифицирует каждый запрос отдельно.

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

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

OPENAPI_COMPANY_TOKEN

Шаг 1 — Получите учётные данные

Настройка занимает несколько минут. Нужны аккаунт Openapi.com на console.openapi.com с балансом в кошельке (wallet) или подпиской на Company API и токен со scopes Company.

1. Войдите на console.openapi.com и пополните баланс или оформите подписку на Company API.
2. Создайте токен с нужными scopes Company в разделе Tokens консоли или через OAuth API. Scope называет эндпоинт, например GET:company.openapi.com/IT-advanced для openapi_company_it_advanced. Один токен может нести несколько scopes и действует до одного года.
3. Скопируйте токен в OPENAPI_COMPANY_TOKEN: только сам токен, без Bearer. Коннектор отправляет его как Authorization: Bearer ....
4. Установите коннектор. Чтобы проверить подключение, запросите через openapi_company_it_start знакомый вам номер НДС; этот вызов тоже платный.

Каждый вызов платный: Openapi.com списывает каждый запрос с вашего аккаунта, с баланса кошелька или по подписке, по цене за эндпоинт, указанной на console.openapi.com. Бесплатных инструментов нет. openapi_company_it_full — самый дорогой вызов API; цена openapi_company_it_search зависит от числа результатов и запрошенного обогащения данных. ИИ выбирает самый дешёвый инструмент, который отвечает на вопрос (openapi_company_it_start или openapi_company_it_name раньше openapi_company_it_advanced, openapi_company_it_advanced раньше openapi_company_it_full), не повторяет запрос, ответ на который уже есть, и сначала запускает поиск с dryRun 1: так он получает число совпадений и цену и сообщает их вам до настоящего поиска.

Scopes определяют, что работает: вызов эндпоинта, для которого у токена нет scope, отвечает 403. В этом случае создайте токен с нужными scopes GET:company.openapi.com.

Продакшен или песочница для проб: коннектор обращается к продакшену https://company.openapi.com. У Openapi.com есть и песочница https://test.company.openapi.com со своими sandbox-токенами и фиксированным списком тестовых компаний. Чтобы попробовать её, смените base URL коннектора на адрес песочницы и используйте sandbox-токен. Sandbox-токен на продакшене отвечает 401.

Cloud и self-hosting работают одинаково: токен — единственные учётные данные, и в обоих случаях коннектор обращается к одному и тому же адресу Openapi.com.

Какие страны: Италия подробно, по данным торговой палаты, итальянской налоговой службы (Agenzia delle Entrate) и реестра IPA органов государственного управления. Для других стран ЕС openapi_company_eu_vies_check проверяет номер НДС в VIES, а openapi_company_eu_start возвращает базовые данные для префиксов AT, BE, BG, CY, CZ, DE, DK, EE, EL, ES, FI, FR, GB, HR, HU, IE, IT, LT, LU, LV, MT, NL, PL, PT, RO, SE, SI и SK. openapi_company_ww_start и openapi_company_ww_advanced охватывают компании любой страны, с расширенными данными там, где их дают источники этой страны. Эндпоинты Openapi.com для отдельных стран (FR, DE, ES, PT, GB, BE, AT, CH и PL) не включены: их заменяют мировые инструменты.

Идентификаторы: итальянский номер НДС (partita IVA) состоит из 11 цифр (12485671007), налоговый код (codice fiscale) компании обычно совпадает с этими 11 цифрами, у индивидуального предпринимателя он из 16 символов. Ответы также содержат id Openapi, который большинство итальянских инструментов принимает вместо номера. openapi_company_eu_vies_check принимает код страны отдельно (EL для Греции), openapi_company_eu_start — префиксом (DE123456789), а мировые инструменты — двухбуквенный код страны ISO вместе с номером НДС, налоговым кодом, регистрационным номером или id Openapi.

Поиск компаний: openapi_company_it_search фильтрует по названию (не меньше 3 символов, * как подстановочный знак), провинции, коммуне, коду ATECO, организационно-правовой форме (коды из openapi_company_it_legal_forms), статусу в торговой палате, обороту, числу сотрудников, участнику, PEC, коду SDI или радиусу вокруг точки. Без dataEnrichment он возвращает только id, с dataEnrichment — данные компаний, которые тарифицируются за каждый результат. Не больше 1000 результатов за вызов; страницы листаются через skip и limit.

Медленные источники: когда реестры отвечают медленно, тяжёлый вызов вроде openapi_company_it_full или openapi_company_it_stakeholders через 30 секунд возвращает id запроса и статус PENDING. Тогда ИИ чуть позже вызывает openapi_company_check_request с этим id, а не платит за запрос повторно.

Не входит: асинхронные POST-варианты с callback, пакеты AML и маркетинга и отслеживание изменений (/monitor).

Частые ошибки: неудачный вызов содержит success: false, код error и message. 401 — токена нет, он неверный или истёк, либо это sandbox-токен на продакшене. 402 — на аккаунте не хватает баланса для этого вызова: пополните его на console.openapi.com. 403 — у токена нет scope для этого эндпоинта. 404 — компания не найдена, 406 — номер НДС или налоговый код в неверном формате. 429 — слишком много запросов или национальный реестр VIES перегружен: подождите немного и повторите.

Что читает коннектор: по итальянским компаниям — название, номер НДС, налоговый код, адрес и статус деятельности; код ATECO, организационно-правовую форму, номер REA, уставный капитал, оборот и число сотрудников по последним балансам, даты регистрации и прекращения деятельности; полное досье с руководителями и более чем 400 показателями баланса; PEC с историей и код SDI для электронных счетов; участников с долей больше 10 процентов, заинтересованных лиц, компании, в которых у неё есть доли, и конечных бенефициаров; прекращён ли номер НДС, входит ли компания в НДС-группу и есть ли она в списках split payment; органы государственного управления с их подразделениями IPA и кодами SDI; коды организационно-правовых форм. По другим странам — действительность в VIES с названием и адресом, а также базовые или расширенные данные компаний по всему миру.

Только чтение: все инструменты только читают. В Openapi.com и в реестры ничего не записывается, поэтому при установке ни один инструмент не отключён; но каждый вызов всё равно платный.

Шаг 2 — Установите адаптер

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Шаг 3 — Добавьте коннектор в Gemini

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Gemini CLI читает MCP-серверы из ~/.gemini/settings.json (в Windows — %USERPROFILE%\.gemini\settings.json). Добавь:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти gemini.
3. Выполни /mcp в Gemini CLI (или gemini mcp list в терминале) — anythingmcp должен отображаться как подключённый.
4. Начинай писать промпты: Gemini CLI теперь может вызывать инструменты Openapi.com Company.

Доступные инструменты

Примеры запросов

• «Проверьте номер НДС 12485671007, прежде чем я выставлю счёт: название компании, действует ли она ещё, код SDI и PEC.»
• «Кто участники и конечные бенефициары компании с номером НДС 12485671007?»
• «Прежде чем выставить счёт этому госоргану, проверьте, есть ли он в списках split payment, и дайте коды SDI его подразделений.»
• «Сколько действующих компаний с кодом ATECO 62.01.00 в провинции Милан? Назовите цену до того, как запустите поиск.»
• «Действителен ли в VIES немецкий номер НДС DE123456789 и какое название компании за ним зарегистрировано?»

FAQ

Где Gemini CLI ищет MCP-серверы? В ~/.gemini/settings.json для твоего пользователя или в .gemini/settings.json внутри проекта. gemini mcp list показывает каждый сервер и статус подключения.

Следующие шаги

• Страница коннектора
• Подключить к Claude