Este artigo mostra como instalar o Coletum MCP no Claude, a inteligência artificial da Anthropic, e fazer a primeira conversa. Para saber o que o Coletum MCP faz, veja Coletum MCP: conecte sua IA aos dados do Coletum.
Um plano pago do Claude.
Uma conta de administrador no Coletum, para gerar o token.
Gere o token no Coletum. Veja como no artigo do Coletum MCP.
O Coletum MCP funciona no Claude Code: na aba Code do Claude Desktop e no terminal.
Adicione o marketplace do Coletum. Clique em Personalização, abra Plugins e, no botão Adicionar, escolha Adicionar marketplace.
No campo URL, digite geo-sapiens/coletum-mcp e clique em Sincronizar.
Digite geo-sapiens/coletum-mcp e clique em Sincronizar.
Instale o plugin. O plugin Coletum, por GeoSapiens, aparece na lista. Clique em Adicionar.
O plugin do Coletum, por GeoSapiens.
Confirme. O Claude avisa que este plugin inclui servidores MCP locais: é o próprio conector, que roda no seu computador. Clique em Continuar. Aparece a mensagem de que o Coletum está instalado e pronto para uso.
Continuar conclui a instalação.
Faça a primeira conversa na aba Code. Abra a aba Code, comece uma conversa nova e peça "liste meus formulários do Coletum". O Claude avisa que falta o token: cole o token do Coletum na conversa. Ele testa e guarda o token, e nas próximas conversas não pede mais.
O token colado e aceito, e a lista dos seus formulários.
Use a aba Code: no Chat e no Cowork o conector ainda não roda.
No Claude Code, rode:
/plugin marketplace add geo-sapiens/coletum-mcp
/plugin install coletum@coletum-mcpA instalação pede o token: cole o token do Coletum. Depois, peça "liste meus formulários do Coletum".
No Claude Code, a atualização automática vem desligada para marketplaces de terceiros, como o do Coletum. Para pegar a versão nova, rode:
/plugin marketplace update coletum-mcpOu, em /plugin, abra Marketplaces, escolha coletum-mcp e ative Enable auto-update. Depois de atualizar o plugin, feche e abra o Claude de novo.
A API V1 (GraphQL, em /api/graphql) será desligada em 01/11/2026. Se você tem um script, uma consulta do Power BI ou um código em R, Python ou JavaScript que ainda chama a V1, o plugin ajuda na troca: cole o código na conversa, ou diga onde está o arquivo, e peça ao Claude para converter para a V2 (REST, em /api/webservice/v2). Ele reescreve o código mantendo o mesmo resultado.
Exemplo: "Converte este script da API V1 para a V2"
Faça a troca antes de 01/11: conferir que o resultado ficou igual depende de rodar a versão antiga, que deixa de funcionar nessa data.
Onde ficam os arquivos: na pasta Documentos › Coletum › saidas, e os modelos salvos em Documentos › Coletum › modelos. O Claude mostra o caminho completo de cada arquivo. Para abrir, é só pedir "abre o arquivo".
Na primeira vez, o plugin baixa os componentes de que precisa (uns 60 MB). Depois não baixa de novo.
Também funciona no ChatGPT: veja Coletum MCP no ChatGPT.
Se você tiver mais perguntas ou precisar de outras orientações:
Consulte nossos outros artigos na Central de Ajuda.
Entre em contato com nossa equipe de suporte através dos Canais de Atendimento.
Estamos aqui para ajudar você a aproveitar ao máximo o Coletum!