Digital · manual de uso

Conecte na IA que você já usa.

O Digital funciona dentro do seu modelo de IA: você conecta uma vez e as operações aparecem como ferramentas na conversa — só as do seu plano. A chave de acesso chega por e-mail depois do começo rápido.

Antes de começar

Troque SUA_CHAVE pela chave recebida por e-mail. Ela é pessoal: identifica o seu plano e o que ele libera. Não a compartilhe nem a publique.

01·Claude Code (terminal e IDE)

Um comando registra o servidor; a partir daí as operações aparecem como ferramentas da conversa.

claude mcp add --transport http fidenza https://fidenza.app.br/api/mcp \
  --header "Authorization: Bearer SUA_CHAVE"

02·Claude Desktop e Claude.ai

Em Configurações → Conectores, adicione um conector personalizado com a URL abaixo. Se o seu plano só aceitar URL (sem cabeçalho), use a ponte no arquivo de configuração:

{
  "mcpServers": {
    "fidenza": {
      "command": "npx",
      "args": ["mcp-remote", "https://fidenza.app.br/api/mcp",
               "--header", "Authorization: Bearer SUA_CHAVE"]
    }
  }
}

03·Cursor

Crie (ou edite) o arquivo .cursor/mcp.json na raiz do projeto:

{
  "mcpServers": {
    "fidenza": {
      "url": "https://fidenza.app.br/api/mcp",
      "headers": { "Authorization": "Bearer SUA_CHAVE" }
    }
  }
}

04·ChatGPT e outros clientes

O suporte a MCP varia por plataforma e plano. Onde houver "conectores/MCP", aponte para a URL com a sua chave no cabeçalho Authorization. Onde só houver stdio, a mesma ponte mcp-remote resolve. Em dúvida, escreva para nós — indicamos o caminho do seu cliente.

URL do servidor:  https://fidenza.app.br/api/mcp
Cabeçalho:        Authorization: Bearer SUA_CHAVE

Primeiro teste · confirme que a chave está viva

Antes de configurar qualquer cliente, cole isto no terminal. Se voltar a lista de operações, sua chave está ativa:

curl -s -X POST https://fidenza.app.br/api/mcp \
  -H "Authorization: Bearer SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Lista vazia ("tools":[]) significa chave inválida, expirada ou cancelada — confira em sua conta.

Gerencie sozinho, na sua conta

Chaves por pessoa: Crie uma chave nomeada para cada membro da equipe (João, Victor…). O resultado sai identificado — você sabe quem operou o quê. Revogue uma sem afetar as outras.
Rotação: Suspeitou que a chave vazou? Rotacione: emitimos uma nova com os mesmos acessos e cancelamos a antiga na hora. Sem falar com ninguém.
Cancelamento: Cancele quando quiser, direto na conta, sem justificar e sem fidelidade (Código de Defesa do Consumidor). O acesso vale até o fim do período pago.

Se algo travar

A IA não vê as ferramentas: Reinicie o cliente depois de configurar (Claude Desktop e Cursor só leem o arquivo ao iniciar). Confirme que a chave está no cabeçalho Authorization, com a palavra Bearer antes.
"Operação não está no seu plano": A chave é válida, mas aquela operação pertence a outra área. A resposta diz qual — ampliar é um passo, sem refazer a configuração.
Preço não encontrado numa página: Alguns sites montam o preço via JavaScript depois do carregamento; nós lemos o HTML publicado. Não inventamos número: quando não achamos, dizemos que não achamos.
"Endereço não permitido": Por segurança, só buscamos endereços públicos. Endereços internos (localhost, redes privadas) são recusados de propósito.

Como usar depois de conectar

Peça em linguagem natural: "calcule o custo de importação deste item", "priorize estes leads", "monte o DRE do mês". A IA escolhe a operação certa.
A lista de ferramentas mostra só o que o seu plano libera. Para ampliar, é um passo — sem refazer nada.
Cada resultado sai com a assinatura Fidenza. Nas operações de importação, mostramos também como resolvemos a remessa internacional, se você precisar.

Ficou preso em algum passo? Responda o e-mail do seu acesso — a gente conecta com você.