aicrm-mcp 0.0.0-stage → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,3 +1,38 @@
1
- # Temporary Holding Version
1
+ # aicrm-mcp
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ 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.
4
+
5
+ ## Começar
6
+
7
+ ```bash
8
+ npx -y aicrm-mcp login --url https://aicrm.up.railway.app # email e senha no terminal; a senha nunca passa pelo LLM
9
+ claude mcp add aicrm -- npx -y aicrm-mcp # Claude Code
10
+ npx -y aicrm-mcp skill install # guia para agentes em ~/.claude/skills/aicrm
11
+ ```
12
+
13
+ Outros clientes:
14
+
15
+ - **Claude Desktop** (`claude_desktop_config.json`): `{ "mcpServers": { "aicrm": { "command": "npx", "args": ["-y", "aicrm-mcp"] } } }`
16
+ - **Opencode** (`opencode.json`): `{ "mcp": { "aicrm": { "type": "local", "command": ["npx", "-y", "aicrm-mcp"] } } }`
17
+ - **Automações**: `AICRM_URL=… AICRM_TOKEN=… npx -y aicrm-mcp`
18
+
19
+ ## Comandos
20
+
21
+ | Comando | O que faz |
22
+ |---|---|
23
+ | `aicrm-mcp login [--url] [--email]` | Troca email e senha por um token revogável (`~/.config/aicrm/credentials.json`, chmod 600) |
24
+ | `aicrm-mcp whoami` | Mostra com quem você está conectado |
25
+ | `aicrm-mcp logout` | Revoga o token e apaga as credenciais |
26
+ | `aicrm-mcp skill [install] [--project \| --dir <pasta>]` | Imprime ou instala o SKILL.md para agentes |
27
+ | `aicrm-mcp` | Inicia o servidor MCP (stdio) |
28
+
29
+ ## Ferramentas (43)
30
+
31
+ - **Leads**: `list_workspaces`, `search_leads`, `get_lead`, `create_lead`, `update_lead`, `move_lead`, `mark_won`, `mark_lost`, `reopen_lead`, `add_note`, `bulk_update_leads`, `delete_lead`
32
+ - **Importação**: `import_leads_csv` (`dry_run`, `columns`, `template_name`), `rename_import_template`, `delete_import_template`
33
+ - **Campos**: `list_fields`, `create_field`, `update_field`, `archive_field`, `set_standard_fields`
34
+ - **Metas**: `get_dashboard`, `get_forecast`, `get_goals`, `set_goals`, `list_commission_plans`, `save_commission_plan`, `delete_commission_plan`
35
+ - **Time e estrutura**: `list_users`, `invite_user`, `resend_invite`, `update_user`, `create_workspace`, `update_workspace`, `delete_workspace`, `create_funnel`, `update_funnel`, `delete_funnel`
36
+ - **Operação**: `get_setup_status`, `create_tv_link`, `list_tv_links`, `revoke_tv_link`, `list_api_tokens`, `revoke_api_token`
37
+
38
+ 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`).