Conectar Peakly con Claude

Peakly ofrece un conector basado en el estándar MCP (Model Context Protocol). Una vez autorizado, podés pedirle a Claude cosas como "¿cuánto facturé este mes?" o "armame una factura en borrador para este cliente" y Claude consulta tus datos de Peakly directamente. Sirve para quienes ya trabajan con Claude y quieren sumar la facturación a su flujo.

Antes de empezar

• Una cuenta de Peakly activa con acceso a la organización que querés conectar
• Claude con conectores personalizados: Claude.ai (planes Pro, Max o Team) o Claude Desktop

Cómo conectar Claude

1. En Claude, andá a Settings > Connectors > Add custom connector
2. Cargá el nombre Peakly y la URL https://api.peakly.ar/mcp. Guardá (para ChatGPT u otro cliente MCP, usá la misma URL en su sección de conectores)
3. Claude abre la pantalla de autorización de Peakly. Si hace falta, iniciá sesión con tu cuenta (podés usar Cambiar cuenta si entraste con otro usuario)
4. En Organización, elegí la organización que querés conectar
5. Revisá los permisos que pide Claude y hacé clic en Autorizar
6. Volvés a Claude con el conector conectado y listo para usar

Qué puede hacer Claude

Los permisos se piden al autorizar. En la pantalla figuran dos niveles:

• Lectura (peakly:read): ver clientes, productos, comprobantes de venta y reportes. Claude puede buscar clientes y productos, listar y ver comprobantes (con importes y CAE), consultar estadísticas de ventas y ver los datos de la organización
• Escritura (peakly:write): además puede crear clientes y productos, crear y editar borradores de comprobantes, y operar sobre el ciclo de vida del comprobante (confirmar, anular, reintentar, duplicar o eliminar borradores)

Ver y revocar conexiones

Las conexiones activas se administran desde Integraciones: abrí Claude (o ChatGPT, que usa el mismo mecanismo) y en el panel de detalle vas a ver la tarjeta Conexiones MCP. Cuando hay un cliente conectado, la integración pasa a Conectada (se detecta por el nombre del cliente). La tabla muestra el Cliente, los Permisos (Lectura / Escritura), cuándo quedó Conectado y el Último uso. El enlace Cómo conectar de la tarjeta abre la guía de conexión de Peakly (peakly.ar/connect).

1. Hacé clic en Revocar en la fila de la conexión
2. Confirmá en el cuadro ¿Revocar conexión MCP?
3. El cliente deja de tener acceso hasta que lo vuelvas a autorizar. La acción no se puede deshacer

Seguridad

• El acceso queda limitado a la organización que elegiste al autorizar
• La autorización usa OAuth 2.1 con PKCE: Claude nunca ve tu contraseña
• El token de acceso vence a la hora y se renueva solo
• Podés revocar el acceso cuando quieras, desde Claude o desde Peakly

Si algo no anda

• No veo mis datos: probablemente autorizaste otra organización. Quitá el conector en Claude y volvé a agregarlo eligiendo la correcta
• Tengo varias organizaciones: cada conexión es de una sola organización; para cambiar, reconectá
• Me pide autorizar de nuevo: si tu sesión venció, reconectá desde Connectors > Peakly
• La pantalla dice que no tenés organizaciones activas: tu usuario no tiene acceso a ninguna organización; pedile una invitación al administrador