Qualsiasi client MCP

Un unico server ospitato

Il server è ospitato su https://mcp.foir.dev/mcp e parla Streamable HTTP. Ogni tool chiama gli stessi RPC della piattaforma usati dalla console e dalla CLI, quindi validazione e scoping a livello di riga restano alla piattaforma. Le scritture dei record arrivano come bozze sui modelli con la pubblicazione attiva, e pubblicare ed eliminare sono tool separati. Il tuo agente porta il proprio modello, quindi collegarlo non consuma crediti AI.

Due modi per autenticarsi

Il primo è il login. Aggiungi l'URL del server al tuo client, e al primo utilizzo si apre nel browser una schermata di consenso di Fóir, dove concedi l'accesso fino al tuo livello. L'agente agisce poi come te.

Il secondo è una chiave API, segreta, adatta a CI e a job non presidiati. foir mcp avvia un proxy locale verso il server ospitato e usa la chiave in FOIR_API_KEY quando è impostata. La portata dell'agente è allora quella degli scope della chiave. Una chiave pubblica viene rifiutata.

Cosa può raggiungere un agente autenticato

Dopo il login il token dell'agente può solo scoprire a cosa hai accesso. Deve entrare in un workspace, e facoltativamente in un progetto e in una organizzazione, cosa che produce un working token con i tuoi permessi effettivi lì. I working token durano 30 minuti e vengono riemessi, e workspace e progetto non possono essere scelti per chiamata.

L'elenco dei tool viene filtrato a ogni richiesta in base a ciò che la credenziale detiene, quindi due persone che collegano lo stesso agente allo stesso progetto possono vedersi offrire tool diversi.

Connessioni di sola lettura

Spunta Sola lettura nella schermata di consenso e all'agente vengono offerti solo tool di lettura. Il consenso è il tetto qualunque cosa l'agente legga in seguito, quindi un'istruzione nascosta nel contenuto non può trasformare un grant di sola lettura in una scrittura. Il proxy CLI ha un flag corrispondente per una sessione autenticata. Non può restringere una chiave.