Conectar um agente de IA (Claude) via MCP

Ligue um agente de IA (como o Claude) ao seu CRM pelo servidor MCP nativo. O agente lê e cria registros (leads, contatos, oportunidades) com segurança, usando a sua API key.

O MCP (Model Context Protocol) é o padrão que permite a um agente de IA conversar com sistemas externos. O Sellio tem um servidor MCP nativo: você aponta o agente (por exemplo o Claude, rodando no Claude Desktop ou em qualquer cliente MCP) para a URL do servidor e ele passa a poder consultar e criar registros no seu CRM: ideal para um agente de prospecção que cria leads e contatos automaticamente. Tudo é feito no contexto do tenant dono da API key e respeita as validações e permissões (RBAC) do CRM.

Pré-requisitos

• Um cliente MCP (Claude Desktop, ou qualquer app/agente que fale MCP por HTTP).
• No Sellio, ser administrador para gerar a API key em Configurações → API e desenvolvedores.

1) Gere uma API key

1. Abra Configurações → API e desenvolvedores (também acessível pelo atalho no menu lateral).
2. Crie uma nova API key e copie o valor (começa com sk_ e só aparece uma vez; trate como uma senha).
3. A mesma chave serve para a API REST e para o MCP.

2) Aponte o agente para o servidor MCP

A URL do servidor MCP é https://SEU-CRM/api/mcp e a autenticação é a mesma da REST: o cabeçalho Authorization: Bearer sk_...

No Claude Desktop (e clientes que usam a ponte mcp-remote), adicione ao arquivo de configuração de servidores MCP:

3) Ferramentas que o agente ganha

• list_objects: descobre os objetos disponíveis (leads, contatos, empresas, oportunidades e objetos personalizados).
• describe_object: descobre os campos de um objeto: apiName, rótulo, tipo, se é obrigatório, as opções aceitas por um select e o objeto alvo de um lookup. Chame antes de criar ou atualizar.
• list_records: lista e busca registros de um objeto (busca, filtros de campo, ordenação, paginação).
• get_record: busca um registro pelo id.
• create_record: cria um registro (por exemplo, um novo lead de prospecção).
• update_record: atualiza campos de um registro existente.
• delete_record: move um registro para a lixeira (reversível). Só funciona quando a chave de API tem o escopo de exclusão habilitado, que vem desligado por padrão.
• bulk_create_records: cria até 500 registros em uma única chamada, com sucesso ou falha relatados por item.
• bulk_update_records: atualiza até 500 registros por id em uma única chamada, com sucesso ou falha relatados por item.
• export_records: retorna os registros de um objeto como linhas tabulares planas com colunas estáveis, com updated_since e created_since para sincronização incremental. Feito para ferramentas de BI e automação.
• list_activities: lista as atividades de um registro (sua linha do tempo) ou as mais recentes do workspace.
• create_activity: registra uma tarefa a fazer, ou uma ligação, e-mail, reunião ou nota que já aconteceu.
• update_activity: conclui, reabre, reagenda, reatribui ou registra o resultado de uma atividade.
• delete_activity: exclui uma atividade. Exige o escopo de exclusão.
• list_attachments: lista os arquivos anexados a um registro.
• get_attachment: retorna os metadados de um anexo e um link de download assinado que expira em 5 minutos.
• create_attachment_upload_url: etapa 1 de um upload: retorna uma URL assinada para onde os bytes do arquivo são enviados com PUT (máximo de 25 MB).
• register_attachment: etapa 2 de um upload: registra o arquivo enviado no registro para que apareça na linha do tempo.
• delete_attachment: exclui um anexo e seu arquivo. Irreversível, por isso exige o escopo de exclusão.
• list_inventory: saldo em estoque, quantidade reservada e disponível por produto, de um produto específico, ou só os produtos abaixo do mínimo.
• list_line_items: linhas de produto de uma oportunidade (quantidade, preço, desconto, imposto) e o total recalculado.
• add_line_item: adiciona uma linha de produto a uma oportunidade. Os totais e o valor da oportunidade são recalculados com o mesmo mecanismo que a tela usa.
• update_line_item: altera quantidade, preço, desconto, imposto, prazo ou descrição de uma linha de produto.
• delete_line_item: remove uma linha de produto de uma oportunidade.
• send_marketing_email: envia um e-mail de marketing (para, assunto, html) pelo provedor configurado, com o rodapé de descadastro adicionado automaticamente.

Referência completa da API REST e do MCP (endpoints, parâmetros, formato de erro, rate limit e descoberta de campos): veja o artigo "Referência para desenvolvedores: API REST e MCP", aqui na Central de Ajuda.

Como testar

1. Conecte o agente e peça algo como "liste os objetos do meu CRM": ele deve chamar list_objects e trazer a lista.
2. Peça "crie um lead chamado Ana Souza com e-mail ana@acme.com": o agente chama create_record e devolve o id do registro criado.
3. Confirme no CRM que o registro apareceu na listagem do objeto.

Solução de problemas

• 401 Unauthorized: a API key está ausente/errada. Gere uma nova em Configurações → API e desenvolvedores e reconfigure o agente com Authorization: Bearer sk_...
• O agente não vê o servidor: confirme a URL https://SEU-CRM/api/mcp e, no Claude Desktop, que o bloco mcpServers está no arquivo de configuração e o app foi reiniciado.
• Uma ação foi recusada: o MCP respeita as permissões (RBAC) e as validações do CRM: a mensagem de erro explica o motivo (campo obrigatório, sem permissão, limite do plano, etc.).
• Só vejo meus dados: correto, cada API key é isolada ao tenant dono; o agente nunca enxerga dados de outra empresa.

Abrir este artigo dentro do sistema →