Construye sobre los datos que tu equipo ya usa.
Una API REST, un servidor MCP para otras herramientas de IA y webhooks a través de Automatización. Cada llamada actúa como una persona, con los permisos de esa persona, y queda en el mismo registro de auditoría.
Todo esto está construido. Como el resto de Cyril, el acceso se abre con el acceso anticipado, organización por organización.
# Facturas vencidas, como la persona propietaria de la clave curl "https://app.getcyril.com/api/finance/invoices?status=overdue&limit=2" \ -H "X-API-Key: $CYRIL_API_KEY" { "data": [ { "number": "ROWA-0998", "status": "overdue", "currency": "EUR", "total": "50595.00", "amountPaid": "0.00" }, { "number": "ROWA-0997", "status": "overdue", "currency": "EUR", "total": "5272.00", "amountPaid": "0.00" } ], "meta": { "page": 1, "limit": 2, "total": 2, "totalPages": 1 } }
# ¿Qué puedo llamar y qué necesita cada herramienta? curl "$CYRIL_MCP_URL/" # Busca en todo Cyril como el propietario de la clave. # Los registros que no puede ver simplemente no se devuelven. curl -X POST "$CYRIL_MCP_URL/tools/call" \ -H "X-API-Key: $CYRIL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "tool": "search_cyril", "input": { "query": "Cernícalo", "entityTypes": ["project", "ticket", "invoice"] } }'
Los mismos permisos, llame quien llame.
Una clave pertenece a una persona de tu organización. Un script, otra herramienta de IA o una automatización que la use obtiene exactamente el acceso de esa persona, y cada cambio queda registrado a su nombre.
X-API-Key- Lee y edita facturas
- Lee empresas y contactos
- Sin acceso a los expedientes de RR. HH.
- No puede eliminar nada
403.Una API REST sin sorpresas.
La misma API sobre la que está construida la aplicación Cyril, con las mismas reglas. Rutas predecibles, una sola forma de respuesta y errores con los que puedes actuar.
- Una referencia que no se desfasaGenerada a partir de los mismos esquemas con los que valida la aplicación. Los administradores la abren desde Configuración, en Claves de API.
- Claves que controlas túCrea, limita y revoca claves por organización. Cada clave tiene su propio límite de frecuencia.
- Una ruta por recursoAnidadas por aplicación, como
/api/projects/tasks. Un punto de acceso retirado responde410e indica cuál lo sustituye. - Listas que se paginan igualTodas las listas aceptan
pageylimit, hasta 100 cada vez, e indican cuántos elementos hay. - Un sandbox en el que desarrollarCrea una organización sandbox aparte y prueba sin tocar los datos reales.
Errores Todos los errores tienen la misma forma
| Estado | Código | Cuándo |
|---|---|---|
| 400 | VALIDATION_ERROR | Un campo no ha superado la validación. El mensaje dice cuál. |
| 401 | UNAUTHORIZED | Falta la clave, está revocada o ha caducado. |
| 403 | FORBIDDEN | La clave es válida, pero su persona no tiene permiso. |
| 404 | NOT_FOUND | No existe o pertenece a otra organización. |
| 409 | CONFLICT | Un duplicado, como un correo ya registrado. |
| 410 | GONE | Retirado. El mensaje indica el sustituto. |
| 422 | UNPROCESSABLE | Es válido, pero incumple una regla de negocio. |
| 429 | RATE_LIMITED | Ve más despacio y vuelve a intentarlo. |
{ "error": "No se puede eliminar al último propietario de la organización",
"code": "UNPROCESSABLE" }Deja que otras herramientas de IA trabajen con Cyril.
El servidor MCP ofrece un conjunto de herramientas de Cyril a los asistentes que hablan el Model Context Protocol. Leen libremente, crean donde ayuda y obtienen la misma respuesta que obtendría una persona.
VentasEmpresas, contactos, negocios
- list_companies
- read_company
- list_contacts
- read_contact
- list_deals
- read_deal
- search_sales
- create_contact
- update_deal
- log_activity
- send_email
FinanzasFacturas, presupuestos
- list_invoices
- read_invoice
- list_estimates
- read_estimate
- create_invoice
- create_estimate
ProyectosProyectos, tareas
- list_projects
- read_project
- list_tasks
- read_task
- create_task
- update_task_status
SoporteTickets, centro de ayuda
- list_tickets
- read_ticket
- search_kb
- create_ticket
Documentos y herramientasEspacios, herramientas personalizadas
- list_doc_spaces
- read_doc_space
- list_custom_tools
- read_custom_tool
En todas partesUna sola búsqueda
- search_cyril
LecturaCreación y actualizaciónUna selección; el servidor lista todas las herramientas que ofrece.
- Nada destructivo
- No hay herramienta de eliminar. Borrar registros sigue en manos de las personas, en Cyril.
- Las reglas, por adelantado
- Cada herramienta dice qué permiso necesita y si requiere aprobación, antes de que nadie la llame.
- Cada llamada, registrada
- Las llamadas se registran y se contabilizan como el resto de la IA de Cyril, a cargo de la organización que las hizo.
POST https://ops.robledal.example/hooks/paid
{ "invoice": "ROWA-0999",
"client": "Alimentos Valdeoliva",
"total": "66631.00" }Webhooks, sin escribir un servidor.
En Automatización, cualquier regla puede terminar enviando un webhook a la URL que elijas, con el contenido que elijas. Un webhook entrante también puede iniciar una regla.
Las reglas funcionan sobre los mismos datos y con los mismos permisos que todo lo demás. Más sobre Automatización.
O sáltate el código.
Describe la herramienta que necesitas y Cyril la crea, primero con datos de ejemplo y revisada antes de publicarse. Una calculadora, un informe o una pequeña aplicación interna, dentro de Cyril y con los mismos permisos.
Crea la tuyaQué está listo.
Disponible significa que existe y está probado hoy. Se abre para ti cuando tu organización reciba el acceso anticipado. La lista completa está en qué está listo hoy.
- API RESTTodas las aplicaciones, rutas anidadas por módulo, una sola forma de respuesta
- Disponible
- Referencia de la APIInteractiva, generada a partir de los propios esquemas de la aplicación
- Disponible
- Claves de API y límites de frecuenciaPor organización, con alcance limitado y revocables
- Disponible
- Organización sandboxUn cliente aparte para hacer pruebas
- Disponible
- Servidor MCPHerramientas de lectura y creación en Ventas, Finanzas, Proyectos, Soporte y Documentos
- Disponible
- Webhooks en AutomatizaciónAcciones salientes y disparadores entrantes
- Disponible
- Herramientas personalizadas que escriben en tus datosLas herramientas que creas en Cyril hoy leen; escribir llegará más adelante
- Previsto
Consigue una clave cuando se abra tu plaza.
Cyril abre primero a los miembros fundadores. Conservan su precio y les ayudamos con el cambio, integraciones incluidas.
Un solo correo cuando se abra tu plaza. Nada más.
