Conector MCP do FechaFácil (Claude, Cursor)

No plano Business, conecte o FechaFácil ao Claude Code, ao Claude Desktop ou ao Cursor e pergunte em português o que foi lido, o que parou e o que pede ação.

No plano Business, o FechaFácil tem um conector MCP. O MCP (Model Context Protocol) é o padrão que assistentes de IA como o Claude usam para consultar outros sistemas. Com o conector ligado, você pergunta em português, e o assistente busca a resposta nas suas propostas:

"O que pede ação hoje?"
"Quais propostas foram lidas e pararam?"
"O que a Indústrias Martins leu na proposta do SOC? Ficou muito tempo nos preços?"
"Monte um resumo das propostas enviadas nesta semana, com valor e status."

O conector é somente leitura: ele consulta, não cria nem envia nada.

Antes de começar

Abra Desenvolvedor no menu
Em Chaves de API, crie uma chave (ex.: "Claude do João") e copie. Ela começa com ff_live_ e só aparece uma vez

É a mesma chave da API. Uma chave por pessoa facilita revogar se alguém sair do time.

O endereço do conector é:

https://fechafacil.app/mcp

Claude Code

No terminal:

claude mcp add --transport http fechafacil https://fechafacil.app/mcp \
  --header "Authorization: Bearer ff_live_sua_chave"

Para usar em qualquer pasta, e não só na atual, acrescente --scope user. Depois, numa conversa, peça "liste minhas propostas no FechaFácil".

Cursor

Em mcp.json (no menu de MCP do Cursor):

{
  "mcpServers": {
    "fechafacil": {
      "url": "https://fechafacil.app/mcp",
      "headers": { "Authorization": "Bearer ${env:FECHAFACIL_API_KEY}" }
    }
  }
}

Defina a variável de ambiente FECHAFACIL_API_KEY com a sua chave, para não deixar a chave escrita no arquivo.

Claude Desktop

O Claude Desktop conecta servidores com chave por meio do mcp-remote (precisa do Node 18 ou mais novo). Em Configurações → Desenvolvedor → Editar configuração, no claude_desktop_config.json:

{
  "mcpServers": {
    "fechafacil": {
      "command": "npx",
      "args": ["mcp-remote", "https://fechafacil.app/mcp", "--header", "Authorization:${AUTH_HEADER}"],
      "env": { "AUTH_HEADER": "Bearer ff_live_sua_chave" }
    }
  }
}

A chave vai em env, e não direto em args, por um motivo: no Windows, o espaço depois de "Bearer" quebra o comando.

Os conectores que se adicionam pelo site do Claude ainda não funcionam com o FechaFácil, porque exigem login por OAuth, que esta versão não tem.

O que o assistente consegue consultar

Ferramenta	O que traz
`list_needs_attention`	Perguntas de clientes esperando resposta do time e propostas lidas que pararam há mais de 3 dias
`get_proposal_engagement`	Se o cliente abriu, até onde leu, tempo total, visitas, tempo em cada seção e a chance de fechar com os motivos
`list_proposals`	Propostas, com filtro por status e busca por título ou cliente
`get_proposal`	Cliente, status, valor, seções e itens de preço de uma proposta
`list_clients`	Clientes e quantas propostas cada um recebeu

Os números são os mesmos da página da proposta no FechaFácil.

Segurança

Cada chave só enxerga os dados da sua empresa.
Revogar a chave em Desenvolvedor corta o acesso na hora.
O que o assistente lê passa pelo provedor de IA que você usa (Anthropic, no caso do Claude). Conecte só ferramentas em que você confia, como faria com qualquer dado da empresa.

Perguntas frequentes

Dá para criar ou enviar proposta pelo Claude? Ainda não: o conector é somente leitura. Criar proposta a partir de um modelo está no roteiro.

Aparece "402"? O conector faz parte do plano Business. Veja os planos em /pricing.

Aparece "401"? A chave está errada, incompleta ou foi revogada. Crie outra em Desenvolvedor.

Conector MCP — pergunte ao Claude o que seus clientes leram