Construye sobre los datos que tu equipo ya usa.
Una API REST y un servidor MCP para otras herramientas de IA, ambos en desarrollo, y webhooks a través de Automatización ya disponibles. Una clave no puede hacer más que la persona a la que pertenece.
Los webhooks de Automatización están construidos. La API pública y el conector MCP están en desarrollo; hoy las claves de API solo funcionan con la CLI de CyrilSites.
# En desarrollo: facturas vencidas, como el propietario de la clave curl "https://app.getcyril.com/api/finance/invoices?status=overdue&limit=2" \ -H "Authorization: Bearer $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 } }
# En desarrollo: ¿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 la persona que la creó y no puede hacer más que ella. Hoy las claves funcionan con la herramienta de línea de comandos de CyrilSites; la API pública y el servidor MCP que las usarán están en desarrollo.
clave de API- 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.
En desarrollo: la misma API sobre la que está construida la aplicación Cyril, abierta a tus claves de API. Rutas predecibles, una sola forma de respuesta y errores con los que puedes actuar.
- Una referencia interactivaHoy cubre los endpoints principales de cuenta, facturación, productos y archivos, y se abre desde Configuración, en Claves de API. Se están añadiendo más aplicaciones.
- Claves que controlas túCrea, limita y revoca claves por organización. Los límites de frecuencia y la caducidad por clave todavía no están construidos.
- 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, no es válida o está revocada. |
| 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.
En desarrollo. Las herramientas de Cyril que ofrecerá ya están escritas; todavía no es posible conectarse desde asistentes que hablan el Model Context Protocol.
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 de las herramientas escritas hasta ahora.
- 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.
- Cambios registrados
- Los cambios hechos con una clave quedan en el registro de auditoría a nombre de la persona a la que pertenece.
POST https://ops.robledal.example/hooks/paid
{ "trigger": "invoice.paid",
"payload": {
"invoiceId": "…",
"amount": "66631.00" },
"timestamp": "…" }Webhooks, sin escribir un servidor.
En Automatización, cualquier regla puede terminar enviando un webhook a la URL que elijas, con el evento que la activó. 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.
En desarrollo: describe la herramienta que necesitas y Cyril prepara un borrador con datos de ejemplo, que se revisa antes de publicarse. Una calculadora, un informe o una pequeña aplicación interna, dentro de Cyril.
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 RESTAcceso con tus propias claves de API, en desarrollo
- Todavía no
- Referencia de la APIInteractiva; endpoints principales de cuenta, facturación, productos y archivos
- Disponible
- Claves de APICon alcance limitado y revocables; hoy solo para la CLI de CyrilSites
- Disponible
- Organización sandboxUn cliente aparte para hacer pruebas
- Disponible
- Servidor MCPHerramientas escritas; los clientes MCP todavía no pueden conectarse
- Todavía no
- Webhooks en AutomatizaciónAcciones salientes y disparadores entrantes
- Disponible
- Herramientas personalizadas que escriben en tus datosLas herramientas creadas en Cyril al principio solo leerán; escribir llegará más adelante
- Todavía no
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.
