Claude

claude.ai: en la web, el escritorio o el celular

Se conecta por OAuth, una sola vez, y queda disponible en todos tus dispositivos.

1. En el CRM, entrá a Configuración → Tokens de API. En Aplicaciones conectadas copiá la URL del conector:

   https://api-crm.vancusoft.com/mcp

2. En claude.ai, entrá a Configuración → Conectores → Agregar conector personalizado. Ponele un nombre (por ejemplo, “CRM”) y pegá la URL.

3. claude.ai te trae a la pantalla del CRM para conectar la aplicación: revisá qué pide y tocá Autorizar. Si no tenías sesión, primero te pide entrar.

4. Listo. En una conversación nueva, pedile algo del CRM: “¿Qué tengo hoy?”.

La aplicación aparece en Configuración → Tokens de API → Aplicaciones conectadas, con su último uso. Desde ahí la desconectás.

Claude Code: en la terminal

Se conecta con un token de API.

1. En el CRM, entrá a Configuración → Tokens de API → Nuevo token. Ponele un nombre (“Claude Code en la notebook”) y elegí el vencimiento: 30, 90 o 365 días, o sin vencimiento.

2. El CRM muestra el token una sola vez, junto con el comando para conectar Claude Code. Copiá el comando y corrélo en tu terminal. Tiene esta forma:

   claude mcp add --scope user --transport http crm https://api-crm.vancusoft.com/mcp --header "Authorization: Bearer crm_pat_…"

3. Abrí Claude Code y escribí /mcp: el servidor crm tiene que aparecer conectado.

Consejo

--scope user registra el CRM para todas tus carpetas. Sin eso, Claude Code lo registra solo para la carpeta desde donde corriste el comando y en los otros repositorios no aparece.

Trabajar con el tablero desde Claude Code

Con Claude Code conectado, el ciclo de un requerimiento se hace sin salir de la terminal:

1. “¿Qué sigo en el tablero de App Delivery v2?”: te propone el próximo ítem.
2. “Tomá RF-004”: lo pasa a En curso a tu nombre y te trae todo el detalle (descripción, criterios, dependencias y comentarios) para trabajar.
3. Al terminar: “Verificá los criterios de RF-004 con los tests de test_historial.py, marcá la Definición de Terminado y cerralo con esta resolución…”.
4. Si algo no estaba en el alcance: “Registrá esto como fuera de alcance”, y queda un pedido de cambio en lugar de hacerlo en silencio.

Vincular los commits solos: el repositorio del CRM trae un hook para Claude Code (tools/claude-code/crm_git_link.py) que, después de cada git commit, vincula el commit a los ítems cuyo código aparece en el mensaje (“RF-004: historial de pedidos”). Si algo falla, nunca frena el commit.