Costruisci sugli stessi dati che il tuo team usa già.
Un’API REST e un server MCP per altri strumenti di AI, entrambi in sviluppo, e già oggi webhook tramite Automazione. Una chiave non può fare più della persona che la possiede.
I webhook in Automazione sono costruiti. L’API pubblica e il connettore MCP sono in sviluppo; oggi le chiavi API funzionano solo con la CLI di CyrilSites.
# In sviluppo: fatture scadute, come il proprietario della chiave 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 } }
# In sviluppo: cosa posso chiamare, e cosa serve a ogni strumento? curl "$CYRIL_MCP_URL/" # Cerca in Cyril come il titolare della chiave. # I record che non può vedere semplicemente non vengono restituiti. 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": "Gheppio", "entityTypes": ["project", "ticket", "invoice"] } }'
Un solo insieme di autorizzazioni, chiunque chiami.
Una chiave appartiene alla persona che l’ha creata e non può fare più di quanto possa fare lei. Oggi le chiavi funzionano con lo strumento a riga di comando di CyrilSites; l’API pubblica e il server MCP che le useranno sono in sviluppo.
chiave API- Legge e modifica le fatture
- Legge aziende e contatti
- Nessun accesso alle schede HR
- Non può eliminare nulla
403.Un’API REST senza sorprese.
In sviluppo: la stessa API su cui è costruita l’app Cyril, aperta alle tue chiavi API. Percorsi prevedibili, un’unica forma di risposta ed errori su cui puoi agire.
- Una documentazione interattivaOggi copre gli endpoint principali di account, fatturazione, prodotti e file, e si apre da Impostazioni, in Chiavi API. Altre app sono in arrivo.
- Chiavi che controlli tuCrea, delimita e revoca le chiavi per ogni organizzazione. Limiti di frequenza e scadenza per singola chiave non sono ancora disponibili.
- Un percorso per ogni risorsaAnnidati per app, come
/api/projects/tasks. Un endpoint dismesso risponde410e indica il suo sostituto. - Elenchi che si paginano tutti allo stesso modoOgni elenco accetta
pageelimit, fino a 100 alla volta, e dice quanti elementi ci sono. - Una sandbox su cui sviluppareCrea un’organizzazione sandbox separata e fai le tue prove senza toccare i dati reali.
Errori Ogni errore ha la stessa forma
| Stato | Codice | Quando |
|---|---|---|
| 400 | VALIDATION_ERROR | Un campo non ha superato la validazione. Il messaggio lo indica. |
| 401 | UNAUTHORIZED | La chiave manca, non è valida o è stata revocata. |
| 403 | FORBIDDEN | La chiave va bene; la sua persona non è autorizzata. |
| 404 | NOT_FOUND | Non esiste, oppure appartiene a un’altra organizzazione. |
| 409 | CONFLICT | Un duplicato, come un’email già registrata. |
| 410 | GONE | Dismesso. Il messaggio indica il sostituto. |
| 422 | UNPROCESSABLE | Valida, ma viola una regola di business. |
| 429 | RATE_LIMITED | Rallenta e riprova. |
{ "error": "Impossibile eliminare l’ultimo proprietario dell’organizzazione",
"code": "UNPROCESSABLE" }Fai lavorare altri strumenti di AI con Cyril.
In sviluppo. Gli strumenti di Cyril che offrirà sono già scritti; il collegamento da assistenti che parlano il Model Context Protocol non è ancora disponibile.
VenditeAziende, contatti, trattative
- list_companies
- read_company
- list_contacts
- read_contact
- list_deals
- read_deal
- search_sales
- create_contact
- update_deal
- log_activity
- send_email
FinanzeFatture, preventivi
- list_invoices
- read_invoice
- list_estimates
- read_estimate
- create_invoice
- create_estimate
ProgettiProgetti, attività
- list_projects
- read_project
- list_tasks
- read_task
- create_task
- update_task_status
AssistenzaTicket, centro assistenza
- list_tickets
- read_ticket
- search_kb
- create_ticket
Documenti e strumentiSpazi, strumenti personalizzati
- list_doc_spaces
- read_doc_space
- list_custom_tools
- read_custom_tool
OvunqueUna sola ricerca
- search_cyril
LeggeCrea e aggiornaUna selezione degli strumenti scritti finora.
- Niente di distruttivo
- Non c’è uno strumento di eliminazione. Rimuovere i record resta compito delle persone, in Cyril.
- Regole chiare in anticipo
- Ogni strumento dice di quale autorizzazione ha bisogno e se richiede un’approvazione, prima che qualcuno lo chiami.
- Modifiche registrate
- Le modifiche fatte tramite una chiave vengono registrate nel registro di controllo a nome della persona che la possiede.
POST https://ops.collesorbo.example/hooks/paid
{ "trigger": "invoice.paid",
"payload": {
"invoiceId": "…",
"amount": "66631.00" },
"timestamp": "…" }Webhook, senza scrivere un server.
In Automazione, qualsiasi regola può concludersi inviando un webhook a un URL che scegli tu, con l’evento che l’ha avviata. Anche un webhook in arrivo può avviare una regola.
Le regole girano sugli stessi dati e con le stesse autorizzazioni di tutto il resto. Scopri di più su Automazione.
Oppure lascia stare il codice.
In sviluppo: descrivi lo strumento che ti serve e Cyril ne prepara una bozza su dati di esempio, verificata prima di andare online. Un calcolatore, un report o una piccola app interna, dentro Cyril.
Crea i tuoi strumentiCosa è pronto.
Costruito significa che esiste ed è testato oggi. Si apre per te quando la tua organizzazione ottiene l’accesso anticipato. L’elenco completo è in cosa è pronto oggi.
- API RESTAccesso con le tue chiavi API, in sviluppo
- Non ancora
- Documentazione dell’APIInterattiva; endpoint principali di account, fatturazione, prodotti e file
- Costruito
- Chiavi APIDelimitate, revocabili; per ora solo CLI di CyrilSites
- Costruito
- Organizzazione sandboxUn tenant separato per le prove
- Costruito
- Server MCPStrumenti scritti; i client MCP non possono ancora collegarsi
- Non ancora
- Webhook in AutomazioneAzioni in uscita e trigger in arrivo
- Costruito
- Strumenti personalizzati che scrivono sui tuoi datiAll’inizio gli strumenti creati in Cyril potranno solo leggere; la scrittura arriverà più avanti
- Non ancora
Ottieni una chiave quando si libera il tuo posto.
Cyril apre prima ai membri fondatori. Mantengono il loro prezzo e ricevono aiuto per il trasloco, integrazioni comprese.
Una sola email, quando si libera il tuo posto. Nient’altro.
