# Assistentes de IA

Peça a nota em linguagem natural: "Emita uma nota de R$ 1.500 para a Acme pela manutenção de outubro." O assistente usa o nosso servidor MCP (Model Context Protocol).

## Endereço do servidor

```text
https://app-staging.nota4you.com.br/mcp
```

Transporte Streamable HTTP. Autenticação por OAuth 2.1 (claude.ai, ChatGPT) ou por chave de API com o escopo `mcp` (Claude Code, Cursor, VS Code).

## Mensagem para começar

```text
Leia https://staging.nota4you.com.br/skill.md e siga as instruções.
```

Com o servidor já conectado: "Quero emitir minha primeira NFS-e. Use as ferramentas do servidor nota4you e siga o prompt first_invoice."

## Claude (claude.ai e app)

Em Configurações > Conectores, escolha "Adicionar conector personalizado", cole o endereço do servidor e entre com a sua conta do Nota4You quando o Claude pedir. Na tela de autorização, escolha os escopos e as empresas que o assistente pode usar.

## ChatGPT

Em Configurações > Aplicativos e conectores, ative o modo desenvolvedor, crie um conector com o endereço do servidor e autorize o acesso com a sua conta do Nota4You.

## Claude Code

Com OAuth (o Claude Code abre o navegador para você autorizar):

```bash
claude mcp add --transport http nota4you https://app-staging.nota4you.com.br/mcp
```

Com uma chave de API:

```bash
claude mcp add --transport http nota4you https://app-staging.nota4you.com.br/mcp --header "Authorization: Bearer <sua chave>"
```

## Cursor e VS Code

No app, a página "Comece com IA" tem os botões de instalação. Ou configure à mão:

```json
{
  "mcpServers": {
    "nota4you": {
      "type": "http",
      "url": "https://app-staging.nota4you.com.br/mcp",
      "headers": { "Authorization": "Bearer <sua chave>" }
    }
  }
}
```

## Ferramentas

| Ferramenta | O que faz |
| --- | --- |
| `get_setup_status` | Mostra o que falta para a primeira nota e o próximo passo. |
| `lookup_company` | Consulta o CNPJ no cadastro público. |
| `create_taxpayer` | Cadastra a empresa a partir do CNPJ. |
| `search_service_codes` | Busca códigos de tributação nacional. |
| `create_service`, `list_services` | Cadastra e lista serviços. |
| `search_customers`, `create_customer` | Busca e cadastra clientes. |
| `request_certificate_upload` | Gera um link de uso único para enviar o certificado. |
| `list_taxpayers` | Lista as empresas que o assistente pode usar. |
| `preview_invoice` | Valida a nota e estima os tributos, sem emitir. |
| `emit_invoice` | Emite a nota que você aprovou na prévia. |
| `get_invoice`, `list_invoices` | Consulta a situação, o número, os eventos e o DANFSe. |
| `cancel_invoice` | Cancela uma nota autorizada, depois da sua confirmação. Precisa do escopo `invoices:cancel`. |

Prompts: `first_invoice` (da empresa à primeira nota), `emit_invoice` e `monthly_billing` (várias notas de uma lista).

## Regras de segurança

- O assistente mostra a prévia e pede a sua confirmação antes de emitir. O servidor confere se a nota emitida é igual à prévia.
- O certificado e a senha nunca passam pela conversa: o envio é por link de uso único, direto para o Nota4You.
- Repetir a emissão com a mesma chave de idempotência devolve a mesma nota.
- Os dados que o assistente lê vão para o provedor de IA. Os resultados trazem CPF mascarado e não trazem e-mail nem telefone dos clientes.
- Você limita o acesso por escopo (por exemplo, só leitura) e por empresa, e revoga o acesso em Configurações > Aplicativos conectados.