MCP

Come collegare MCP

Frasma espone il workspace via Model Context Protocol: gli agenti vedono progetti, Kanban e conoscenza indicizzata, e aggiornano le card come faresti tu nell’interfaccia.

https://api.frasma.org/mcp

Come funziona

Stesso board, stessi permessi, più client

Un solo backlog

Il Kanban Frasma resta la source of truth. Cursor, Cloud Agents, Claude, ChatGPT e Grok non tengono copie parallele: leggono e aggiornano le stesse card.

Streamable HTTP e OAuth 2.1

Il client si collega all’endpoint remoto, scopre OAuth dai metadata e registra il client se serve. Tu fai login Frasma e consenti l’accesso.

I tool agiscono come te

Ogni chiamata usa il tuo utente: ruolo, progetti, review e policy commerciale restano quelli del workspace. Un update con versione vecchia viene rifiutato, non sovrascritto.

Come collegare

Quattro client, un URL

In tutti i casi incolli l’endpoint di produzione, fai login Frasma e consenti l’accesso. I tool compaiono nel client con il tuo ruolo.

Cursor
Plugin e Cloud Agents
Documentazione Cursor
1. Installa Frasma dal Cursor Marketplace, oppure aggiungi un server MCP remoto con l’URL di produzione.
2. Quando Cursor chiede Connect, accedi con l’account Frasma e consenti l’accesso.
3. Sui Cloud Agents ripeti Connect su cursor.com/agents. Un admin può anche aggiungere l’URL in Dashboard → Integrations & MCP.
```
{
  "mcpServers": {
    "frasma": {
      "url": "https://api.frasma.org/mcp"
    }
  }
}
```
Cursor Marketplace Cloud Agents
Claude
Connectors
Documentazione Claude
1. In Claude Desktop o Claude.ai aggiungi un connettore remoto con lo stesso URL.
2. Claude scopre OAuth dai metadata e registra il client. Completa il login Frasma.
3. Claude Code usa lo stesso endpoint: dopo il consenso i tool del Kanban compaiono nella sessione.
ChatGPT
Custom GPT + OAuth
Documentazione ChatGPT
1. Apri Impostazioni → Connectors e aggiungi un connettore.
2. Incolla l’URL di produzione. ChatGPT registra il client e apre la schermata di autorizzazione.
3. Accedi con email e password Frasma, poi consenti l’accesso.
Grok
Connectors e Grok Build
Documentazione Grok
1. Su grok.com/connectors scegli New Connector → Custom.
2. Incolla l’URL di produzione e completa il login Frasma.
3. Da quel momento Grok usa gli stessi tool del board: list, create, update, move.
Grok Connectors

Tool

Cosa possono fare gli agenti

Lettura solo sui progetti di cui sei membro. Scrittura con un motivo registrato sulla revisione della card. Niente automazioni irreversibili: create e update rispettano RBAC e review.

list_projects

Elenca i progetti di cui sei membro.

get_project

Mostra impostazioni, ruolo, modalità agente e stato di un progetto.

get_project_workboard

Panoramica Kanban per colonna, con flag su card stale o fuori scope.

list_tasks

Cerca i task per stato, priorità o testo. Di default la board attiva; con archived i completati archiviati.

get_task

Dettaglio di una card: description completa, versione corrente e timestamps.

list_task_conversations

Estratti delle chat che hanno creato, aggiornato o collegato il task.

search_project_knowledge

Cerca nei repository, documenti, task e conversazioni già indicizzati.

create_task

Crea una card. Titolo con area ed esito; description con fatto, atteso e criterio di accettazione.

update_task

Aggiorna campi scelti usando la versione corrente e un motivo. Una versione stale viene rifiutata.

move_task

Sposta una card in un’altra colonna o posizione.

archive_task

Archivia un task già completato, togliendolo dalla board attiva.

unarchive_task

Riporta un task archiviato in Completati.