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
- Entre no Lovable e abra qualquer projeto (ou crie um novo).
- No painel lateral, clique em Chat (ou no ícone de balão).
- No topo do painel de chat, clique em Connectors → Add Custom MCP.
2. Preencher os dados
| Campo | Valor |
|---|---|
| Name | Alcance |
| URL | https://mcp.contabilidadealcance.com.br/api/mcp |
| Auth type | Bearer |
| 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_clientepara localizar a empresa pelo CNPJ e me mostre os campos disponíveis." - "Liste as certidões com
listar_certidoese 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://contabilpara que o LLM entenda termos da casa (CND, FGTS, DARF, etc.).
Troubleshooting
| Sintoma | Soluçã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 certo | Veja a seção de clientes no troubleshooting. |
Mais detalhes em Troubleshooting.