Costruisci sugli stessi dati che il tuo team usa già.
Un’API REST, un server MCP per altri strumenti di AI e webhook tramite Automazione. Ogni chiamata agisce come una persona, con le sue autorizzazioni, e finisce nello stesso registro di controllo.
Tutto questo è già costruito. Come il resto di Cyril, l’accesso apre con l’accesso anticipato, un’organizzazione alla volta.
# Fatture scadute, come la persona che possiede la chiave 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 } }
# 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 a una persona della tua organizzazione. Uno script, un altro strumento di AI o un’automazione che la usa ottiene esattamente l’accesso di quella persona, e ogni modifica viene registrata a suo nome.
X-API-Key- Legge e modifica le fatture
- Legge aziende e contatti
- Nessun accesso alle schede HR
- Non può eliminare nulla
403.Un’API REST senza sorprese.
La stessa API su cui è costruita l’app Cyril, con le stesse regole. Percorsi prevedibili, un’unica forma di risposta ed errori su cui puoi agire.
- Una documentazione che non può disallinearsiGenerata dagli stessi schemi su cui l’app esegue la validazione. Gli amministratori la aprono da Impostazioni, in Chiavi API.
- Chiavi che controlli tuCrea, delimita e revoca le chiavi per ogni organizzazione. Ogni chiave ha il suo limite di frequenza.
- 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, è stata revocata o è scaduta. |
| 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.
Il server MCP dà agli assistenti che parlano il Model Context Protocol una serie di strumenti di Cyril. Leggono liberamente, creano dove serve e ottengono la stessa risposta che otterrebbe una persona.
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; il server elenca tutti gli strumenti che offre.
- 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.
- Ogni chiamata registrata
- Le chiamate vengono registrate e conteggiate come il resto dell’AI di Cyril, a carico dell’organizzazione che le ha fatte.
POST https://ops.collesorbo.example/hooks/paid
{ "invoice": "ROWA-0999",
"client": "Molino Ardesia Alimentari",
"total": "66631.00" }Webhook, senza scrivere un server.
In Automazione, qualsiasi regola può concludersi inviando un webhook a un URL che scegli tu, con il payload che scegli tu. 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.
Descrivi lo strumento che ti serve e Cyril lo costruisce, prima su dati di esempio, verificato prima di andare online. Un calcolatore, un report o una piccola app interna, dentro Cyril, con le stesse autorizzazioni.
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 RESTTutte le app, percorsi annidati per modulo, un’unica forma di risposta
- Costruito
- Documentazione dell’APIInterattiva, generata dagli schemi dell’app stessa
- Costruito
- Chiavi API e limiti di frequenzaPer organizzazione, delimitate, revocabili
- Costruito
- Organizzazione sandboxUn tenant separato per le prove
- Costruito
- Server MCPStrumenti di lettura e creazione su Vendite, Finanze, Progetti, Assistenza e Documenti
- Costruito
- Webhook in AutomazioneAzioni in uscita e trigger in arrivo
- Costruito
- Strumenti personalizzati che scrivono sui tuoi datiOggi gli strumenti che crei in Cyril leggono; la scrittura arriverà più avanti
- Pianificato
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.
