aicrm-mcp 0.4.0 → 0.6.1

package/README.md

@@ -1,11 +1,11 @@
 # aicrm-mcp
 
-Servidor MCP do [AICRM](https://aicrm.up.railway.app): opere o CRM pelo Claude, Opencode, Cursor e outros clientes MCP — leads, pipeline, importação de CSV, campos personalizados, metas, comissões, time e modo TV. Tudo com as permissões do seu usuário.
+Servidor MCP do [AICRM](https://aicrm.dev): opere o CRM pelo Claude, Opencode, Cursor e outros clientes MCP — leads, pipeline, importação de CSV, campos personalizados, metas, comissões, time e modo TV. Tudo com as permissões do seu usuário.
 
 ## Começar
 
 ```bash
-npx -y aicrm-mcp login --url https://aicrm.up.railway.app   # email e senha no terminal; a senha nunca passa pelo LLM
+npx -y aicrm-mcp login --url https://aicrm.dev   # email e senha no terminal; a senha nunca passa pelo LLM
 claude mcp add aicrm -- npx -y aicrm-mcp                      # Claude Code
 npx -y aicrm-mcp skill install                                # guia para agentes em ~/.claude/skills/aicrm
 ```
@@ -23,10 +23,10 @@ Outros clientes:
 | `aicrm-mcp login [--url] [--email]` | Troca email e senha por um token revogável (`~/.config/aicrm/credentials.json`, chmod 600) |
 | `aicrm-mcp whoami` | Mostra com quem você está conectado |
 | `aicrm-mcp logout` | Revoga o token e apaga as credenciais |
-| `aicrm-mcp skill [install] [--project \| --dir <pasta>]` | Imprime ou instala o SKILL.md para agentes |
+| `aicrm-mcp skill [install] [aicrm \| aicrm-integrate] [--project \| --dir <pasta>]` | Imprime ou instala o SKILL.md para agentes: `aicrm` para operar o CRM, `aicrm-integrate` para integrar um sistema pela API |
 | `aicrm-mcp` | Inicia o servidor MCP (stdio) |
 
-## Ferramentas (45)
+## Ferramentas
 
 - **Leads**: `list_workspaces`, `search_leads`, `get_lead`, `create_lead`, `update_lead`, `move_lead`, `mark_won`, `mark_lost`, `reopen_lead`, `handoff_lead`, `add_note`, `bulk_update_leads`, `delete_lead`
 - **Importação**: `import_leads_csv` (`dry_run`, `columns`, `template_name`), `rename_import_template`, `delete_import_template`
@@ -35,4 +35,18 @@ Outros clientes:
 - **Time e estrutura**: `list_users`, `invite_user`, `resend_invite`, `update_user`, `create_workspace`, `update_workspace`, `delete_workspace`, `create_funnel`, `update_funnel`, `delete_funnel`
 - **Operação**: `get_setup_status`, `create_tv_link`, `list_tv_links`, `revoke_tv_link`, `list_api_tokens`, `revoke_api_token`
 
+- **Integração** (papel Desenvolvedor; admins também veem): `get_integration_schema`, `create_api_key` (grava a chave direto no `.env` e no `.gitignore`, sem mostrá-la ao modelo), `send_test_lead`, `list_api_logs`, `get_api_log`, `get_integration_status`, `list_api_keys`, `revoke_api_key`, `clear_test_leads`
+
+## Integrar um sistema com o seu agente
+
+Quem tem o papel **Desenvolvedor** no AICRM pode pedir ao agente para fazer a integração inteira, dentro do próprio projeto:
+
+```bash
+npx -y aicrm-mcp login --url https://aicrm.dev
+claude mcp add aicrm -- npx -y aicrm-mcp
+npx -y aicrm-mcp skill install aicrm-integrate --project
+```
+
+Depois é só pedir: *"integre o formulário de contato deste projeto com o funil Vendas do AICRM"*. O agente lê os funis e os campos obrigatórios, mostra o mapeamento, cria uma chave de teste no `.env`, escreve o código com o SDK `@aicrm-dev/sdk`, roda e confere nos logs. A chave de produção só é criada com o seu ok.
+
 As permissões são aplicadas pelo servidor: um vendedor consegue tudo o que faz no app, e recebe "peça a um admin" nas ações de admin. O guia completo de uso está no SKILL.md (`aicrm-mcp skill`).