brazil-invoice

Let AI agents issue Brazilian NFS-e service invoices (nota fiscal de servico) via Focus NFe.

От сообществаРаботаетБез входаГлобальныйБесплатноМожет изменять данные

Что умеет

  • Create Invoice: Issue a Brazil NFS-e (nota fiscal de serviço eletrônica — the electronic service invoice municipalities/prefeituras require) via Focus NFe. Bring your own Focus NFe API token via heade
  • Query Invoice: Check a Brazil NFS-e created by create_invoice, using its ref. Status values: PROCESSING (prefeitura is still authorizing — poll again shortly), AUTHORIZED (nota autorizada — numero and
  • Cancel Invoice: Cancel (void) an authorized Brazil NFS-e at the prefeitura, using its ref. Requires a justificativa (cancellation reason) of 15 to 255 characters. Only an AUTHORIZED NFS-e can be cance

Какие данные видит

Нужен ли аккаунт

Не нужен: сервер работает без входа

Let AI agents issue Brazilian NFS-e service invoices (nota fiscal de servico) via Focus NFe. Stateless remote MCP server: bring your own key, it stores nothing. Create, query, and cancel invoices with async issuance polling built in.

Как подключить

Как подключить brazil-invoice к Claude

Адрес сервера, который нужно вставить в настройках Claude:

https://brazil-invoice--wishpool.run.tools

  1. Откройте Claude (сайт claude.ai или приложение для компьютера).
  2. Перейдите в Настройки → Коннекторы (в английском интерфейсе: Settings → Connectors).
  3. Нажмите Добавить пользовательский коннектор (Add custom connector).
  4. Вставьте адрес сервера, скопированный ниже, в поле URL удалённого MCP-сервера и нажмите Добавить.
  5. В чате нажмите + → Коннекторы и включите новый коннектор.

Пользовательские коннекторы доступны на тарифах Free, Pro, Max, Team и Enterprise. На Free можно добавить только один. В Team и Enterprise коннектор сначала добавляет владелец организации в Настройки организации → Коннекторы.

Авторизация

После нажатия Добавить откроется окно входа в сервис. Войдите под своим аккаунтом и подтвердите доступ. Пароль Claude не видит.

Как подключить brazil-invoice к ChatGPT

Адрес сервера, который нужно вставить в настройках ChatGPT:

https://brazil-invoice--wishpool.run.tools

  1. Откройте ChatGPT в браузере (chatgpt.com). Нужен тариф Plus, Pro, Business, Enterprise или Edu.
  2. Один раз включите режим разработчика: Настройки → Приложения → Дополнительные настройки → Режим разработчика (Settings → Apps → Advanced settings → Developer mode).
  3. Откройте Настройки → Коннекторы и нажмите Создать (Create).
  4. Заполните форму: Название (любое), Описание (одна фраза, что делает сервис), URL MCP-сервера (скопируйте ниже).
  5. В поле Аутентификация выберите OAuth, если сервис требует вход, иначе Нет. Нажмите Создать.
  6. В новом чате откройте + → Приложения/Коннекторы и включите коннектор.

Название раздела у OpenAI менялось (Connectors → Apps/Plugins). Если пункт называется иначе, ищите «режим разработчика» в настройках. В рабочих пространствах Business/Enterprise администратор должен разрешить пользовательские коннекторы.

Авторизация

При первом использовании ChatGPT откроет окно входа в сервис. Войдите и подтвердите доступ.

Как подключить brazil-invoice к Cursor

Адрес сервера, который нужно вставить в настройках Cursor:

https://brazil-invoice--wishpool.run.tools

Быстрый способ: нажмите кнопку Открыть в Cursor ниже, Cursor сам предложит добавить сервер.

Вручную:

  1. В Cursor откройте Settings → Cursor Settings → MCP и нажмите Add new global MCP server.
  2. Вставьте JSON, скопированный ниже, в открывшийся файл ~/.cursor/mcp.json (для одного проекта: .cursor/mcp.json в корне проекта).
  3. Сохраните файл. Сервер появится в списке MCP; при необходимости пройдите авторизацию по кнопке рядом с ним.

Авторизация

Если сервис требует вход, рядом с сервером в списке MCP появится кнопка авторизации.

Список инструментов сервера (3)

Технические названия из tools/list. Нужны только разработчикам.

create_invoiceIssue a Brazil NFS-e (nota fiscal de serviço eletrônica — the electronic service invoice municipalities/prefeituras require) via Focus NFe. Bring your own Focus NFe API token via header x-focusnfe-token — a free homologação (sandbox) token issues test NFS-e with no fiscal effect; the produção token issues real ones (send header x-focusnfe-mode: production to switch; default is the safer sandbox). The merchant's digital certificate and municipal registration live in their own Focus NFe account; this server never sees or stores them. ISSUANCE IS ASYNCHRONOUS: this returns status PROCESSING plus a ref — poll query_invoice with that ref until the prefeitura authorizes (AUTHORIZED) or rejects (ERROR). This is for service invoices (serviços); NF-e for physical goods is on the v2 roadmap.
query_invoiceCheck a Brazil NFS-e created by create_invoice, using its ref. Status values: PROCESSING (prefeitura is still authorizing — poll again shortly), AUTHORIZED (nota autorizada — numero and codigo_verificacao are populated, url links the official NFS-e), ERROR (authorization was rejected — see message for the reason), CANCELED (voided). Safe to call anytime.
cancel_invoiceCancel (void) an authorized Brazil NFS-e at the prefeitura, using its ref. Requires a justificativa (cancellation reason) of 15 to 255 characters. Only an AUTHORIZED NFS-e can be canceled; cancellation is permanent.