O que capsulemcp faz?
Ferramentas do Capsule CRM para Claude. Instalação local via npx, para toda a organização via Conectores Personalizados. Modo somente leitura suportado.
Visão Geral
Esta skill fornece acesso ao Capsule CRM diretamente através do Claude, permitindo que você consulte, crie e gerencie contatos, oportunidades, tarefas e outros dados do CRM usando linguagem natural.
Instalação
Instalação Local
Use o npx para instalar rapidamente:
npx @soil-dev/capsulemcp
Isso configurará a skill localmente para uso com o Claude Desktop ou outros clientes MCP.
Instalação para Toda a Organização
Para implantar em toda a organização, use Conectores Personalizados conforme a documentação do seu provedor MCP.
Configuração
Antes de usar, você precisa configurar suas credenciais da API do Capsule CRM:
- Obtenha uma chave de API do Capsule CRM (necessita de uma conta Capsule CRM)
- Defina a variável de ambiente:
export CAPSULE_API_KEY=sua_chave_api_aqui
export CAPSULE_SUBDOMAIN=seudominio
Opcionalmente, você pode ativar o modo somente leitura:
export CAPSULE_READ_ONLY=true
Modo Somente Leitura
Quando CAPSULE_READ_ONLY está definido como true, a skill não permitirá nenhuma operação de escrita (criação, atualização ou exclusão). Isso é útil para:
- Ambientes de produção onde alterações acidentais devem ser evitadas
- Usuários que precisam apenas de acesso de consulta
- Integrações de auditoria
Uso
Depois de configurada, você pode interagir com o Capsule CRM usando linguagem natural no Claude. Exemplos:
- "Liste meus contatos do CRM"
- "Encontre todas as oportunidades com valor acima de $10.000"
- "Mostre tarefas vencidas esta semana"
- "Crie um novo contato chamado João Silva da Empresa XYZ" (apenas em modo de leitura/escrita)
Funcionalidades
A skill expõe as seguintes ferramentas MCP:
- listParties: Lista contatos e organizações do CRM
- getParty: Detalhes de um contato ou organização específico
- listOpportunities: Lista oportunidades de negócio
- getOpportunity: Detalhes de uma oportunidade específica
- listTasks: Lista tarefas do CRM
- getTask: Detalhes de uma tarefa específica
- createParty: Cria um novo contato ou organização (apenas em modo de leitura/escrita)
- createOpportunity: Cria uma nova oportunidade (apenas em modo de leitura/escrita)
- createTask: Cria uma nova tarefa (apenas em modo de leitura/escrita)
Suporte
Para problemas ou dúvidas, abra uma issue no repositório GitHub.
Licença
MIT