Instalação no Lovable

O Lovable é um construtor de aplicações com IA que aceita servidores MCP customizados em seus Chat Connectors. Isso permite consultar dados da WebApiAlcance no chat do Lovable, durante a construção do projeto.

Pré-requisito

Conta no Lovable com acesso ao recurso Chat Connectors (planos pagos) e um token do MCP válido.

Pré-requisitos

  • Conta no Lovable com acesso ao recurso Chat Connectors (planos pagos).
  • Token do MCP válido.
  • URL pública do MCP: https://mcp.contabilidadealcance.com.br/api/mcp.

Passo a passo

1. Abrir Chat Connectors

  1. Entre no Lovable e abra qualquer projeto (ou crie um novo).
  2. No painel lateral, clique em Chat (ou no ícone de balão).
  3. No topo do painel de chat, clique em Connectors → Add Custom MCP.

2. Preencher os dados

CampoValor
NameAlcance
URLhttps://mcp.contabilidadealcance.com.br/api/mcp
Auth typeBearer
Token<COLE SEU TOKEN>

Clique em Add Connector. Em poucos segundos a lista de tools (buscar_cliente, listar_certidoes, …) aparece sob o conector.

3. Usar no chat

Com o conector ativo, peça ao chat do Lovable para consultar os dados durante a construção. Exemplos:

  • "Use o tool buscar_cliente para localizar a empresa pelo CNPJ e me mostre os campos disponíveis."
  • "Liste as certidões com listar_certidoes e descreva o formato retornado."

O uso do conector se limita ao chat, em tempo de construção.

Segurança

Não publique aplicações que usem o token do MCP sem autenticação própria: o token dá acesso aos dados de todos os clientes e a ações como envio de lembretes.

4. Boas práticas

Boas práticas de token

Use apenas tokens emitidos para essa integração, com escopo mínimo. Nunca cole o token em código ou no client-side; referencie o conector.

  • Limite a quantidade de tools chamadas por turno. Mais de 4-5 chamadas por prompt tende a falhar; quebre em prompts menores.
  • Combine com o resource glossario://contabil para que o LLM entenda termos da casa (CND, FGTS, DARF, etc.).

Troubleshooting

SintomaSolução
"Failed to fetch tools"URL incorreta ou bloqueio de rede. Teste a URL no navegador (deve retornar resposta MCP, não HTML).
Conector "Unauthorized"Token errado. Edite o conector e cole novamente o valor.
Tool retorna cliente_nao_encontrado mesmo com CNPJ certoVeja a seção de clientes no troubleshooting.

Mais detalhes em Troubleshooting.