Vai al contenuto

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

01

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
POST https://ecentic.ai/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.

02

Handshake

Inizializza, poi invia la notifica initialized.

Esplora l’handshake

  1. 01

    Inizializza

    Il client invia
    initialize
    Il server restituisce
    200

    Protocollo negoziato + capacità del server

    initialize restituisce la versione del protocollo negoziata, l’identità del server, le sue capacità e una stringa instructions che descrive lo scopo di ecentic. Se richiedi una versione supportata da ecentic, viene restituita quella versione; qualsiasi altra richiesta ricade sulla versione pubblicizzata.

  2. 02

    Notifica

    Il client invia
    notifications/initialized
    Il server restituisce
    202

    Accettato con corpo vuoto

    Il messaggio notifications/initialized che segue è una notifica JSON-RPC: non ha un id e non riceve risposta. ecentic risponde con 202 Accepted e 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.

Esempio completo di handshake
Versioni del protocollo accettate da initialize
03

Strumenti

Cosa espone il server e quali chiamate richiedono una chiave.

04

Autenticazione

Gli strumenti in sola lettura sono aperti; tutto ciò che riguarda un account richiede una chiave bearer.

Invia una chiave bearer

Esempio di codice

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.

05

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.