MCP ecentic: server.
Claude, ChatGPT e qualsiasi client Model Context Protocol possono chiamare ecentic in modo nativo tramite JSON-RPC 2.0. Questa pagina è il riferimento per la connessione: endpoint, trasporto, handshake e tutti gli strumenti esposti.
HTTP con streaming · JSON-RPC 2.0 · 7 strumenti
Connetti
Un endpoint, due percorsi, nessuna sessione da gestire.
Riferimento della connessione
- Endpoint principale
- POST https://ecentic.ai/mcp
- Stesso handler
- POST https://ecentic.ai/api/mcp
Il server è raggiungibile su /mcp e /api/mcp. Entrambi usano lo stesso handler; il percorso semplice esiste perché la maggior parte dei client e degli scanner lo verifica per primo.
Il trasporto è Streamable HTTP. Ogni richiesta è una POST che contiene JSON-RPC 2.0 e ogni risposta arriva sulla stessa POST. ecentic non apre stream avviati dal server, quindi una GET con Accept: text/event-stream restituisce 405 invece di lasciare il client in attesa di uno stream che non emetterà mai nulla.
Non esiste una sessione. ecentic non emette alcun Mcp-Session-Id e DELETE — il verbo per terminare la sessione — restituisce 405 per lo stesso motivo. Non c’è nulla da chiudere.
Handshake
Inizializza, poi invia la notifica initialized.
Esplora l’handshake
- 01
Inizializza
- Il client invia
- initialize
- Il server restituisce
- 200
Protocollo negoziato + capacità del server
initializerestituisce la versione del protocollo negoziata, l’identità del server, le sue capacità e una stringainstructionsche descrive lo scopo di ecentic. Se richiedi una versione supportata da ecentic, viene restituita quella versione; qualsiasi altra richiesta ricade sulla versione pubblicizzata. - 02
Notifica
- Il client invia
- notifications/initialized
- Il server restituisce
- 202
Accettato con corpo vuoto
Il messaggio
notifications/initializedche segue è una notifica JSON-RPC: non ha unide non riceve risposta. ecentic risponde con202 Acceptede un body vuoto, come richiesto dal trasporto. Un server che risponde a una notifica con un errore JSON-RPC interrompe l’handshake, quindi questo è il primo scambio da controllare quando un client non riesce a connettersi.
Strumenti
Cosa espone il server e quali chiamate richiedono una chiave.
Autenticazione
Gli strumenti in sola lettura sono aperti; tutto ciò che riguarda un account richiede una chiave bearer.
Invia una chiave bearer
Invia Authorization: Bearer ecentic_sk_… nelle chiamate agli strumenti che modificano lo stato dell’account. Una chiamata che richiede credenziali ma non le riceve restituisce HTTP 401 con un header WWW-Authenticate che indica il documento Protected Resource Metadata, così il client può rieseguire la discovery direttamente a partire dall’errore.
Crea la tua credenziale
Le chiavi sono self-service: crea un account, poi generane una dalla dashboard o chiamando create_api_key tramite una sessione autenticata. Non è previsto alcun contatto commerciale in nessuna fase.
Errori
Due superfici di errore e come capire quale stai guardando.
Errore JSON-RPC
error.code
Un errore JSON-RPC — un metodo sconosciuto, parametri errati, uno strumento che rifiuta la richiesta — arriva come HTTP 200 con un membro error, esattamente come specificato da JSON-RPC. Usa error.code per gestire i casi.
Errore di trasporto
application/problem+json
Un errore di trasporto — un metodo non offerto dall’endpoint — arriva come documento problem RFC 9457 con Content-Type: application/problem+json e un code leggibile da macchina. È lo stesso modello di errore usato dalla superficie REST.
Eccezione di autenticazione
WWW-Authenticate
L’unica eccezione è il 401: include il wrapper JSON-RPC così un client che sta già elaborando JSON-RPC non deve usare un secondo parser, oltre all’header WWW-Authenticate per la discovery.
Ogni affermazione in questa pagina è verificabile: il manifest, la server card e il documento OpenAPI descrivono tutti lo stesso endpoint.