Integrazione MCP

TrueScreen supporta integrazioni MCP oltre alla REST Public API. Questo permette a client AI come Cursor o Claude Desktop di chiamare operazioni TrueScreen curate, senza costruire manualmente richieste HTTP grezze.

TrueScreen espone due server MCP:

• un server MCP remoto per operazioni testuali e JSON,
• un server MCP locale per le stesse operazioni più le procedure che richiedono upload di file dalla tua macchina.

In pratica:

• usa il server MCP remoto quando il workflow e interamente basato su testo o JSON;
• usa il server MCP locale quando il workflow include un file da leggere dalla tua macchina e caricare.

Questi tool sono disponibili sia sul server remoto sia su quello locale:

• truescreen_get_credits
• truescreen_list_templates
• truescreen_create_true_flow
• truescreen_create_hash_certification
• truescreen_create_data_certification
• truescreen_get_certification
• truescreen_wait_for_certification

Questi tool sono disponibili solo sul server locale:

• truescreen_create_file_certification_attachments
• truescreen_upload_file
• truescreen_create_file_certification
• truescreen_create_true_flow_attachment

Usa il server locale quando ti serve:

• la certificazione file, perche il flusso include l'upload di file,
• l'upload di allegati True Flow, perche il file deve essere letto localmente prima del caricamento.

Ogni tool MCP corrisponde a una o più chiamate della Public API. Usa questa tabella per passare dalla superficie MCP al punto corrispondente della documentazione REST.

Se ti serve il contratto a livello di schema per una di queste chiamate, usa anche la specifica OpenAPI insieme alle guide operative.

Il server remoto è l'opzione più semplice quando non ti serve accesso a file locali. Configuri il tuo client MCP con l'URL MCP di TrueScreen e la stessa API key che usi per la REST API.

• Una API key TrueScreen valida
• Un client MCP che supporti Streamable HTTP

Aggiungi questo al tuo mcp.json:

{
  "mcpServers": {
    "truescreen": {
      "url": "https://mcp.truescreen.app/mcp",
      "headers": {
        "Authorization": "Bearer abc..."
      }
    }
  }
}

• La API key viene inviata nell'header Authorization come token Bearer.
• Non e richiesto alcun processo locale Node.js.
• Qualsiasi client MCP con configurazione equivalente di URL e header può usare lo stesso server remoto.

Il server locale gira come processo Node.js sulla tua macchina. E la scelta corretta quando il workflow richiede file presenti su disco.

• Una API key TrueScreen valida
• Node.js 20 o successivo

Aggiungi questo al tuo mcp.json:

{
  "mcpServers": {
    "truescreen-local": {
      "command": "npx",
      "args": ["-y", "@truescreen/mcp"],
      "env": {
        "TRUESCREEN_API_KEY": "abc..."
      }
    }
  }
}

Se ti serve un ambiente non di produzione, puoi impostare anche MCP_ENV a stg.

{
  "mcpServers": {
    "truescreen-local": {
      "command": "npx",
      "args": ["-y", "@truescreen/mcp"],
      "env": {
        "TRUESCREEN_API_KEY": "abc...",
        "MCP_ENV": "stg"
      }
    }
  }
}

• Usa il server locale come pacchetto eseguito dal client MCP, tipicamente con npx -y @truescreen/mcp.
• Nell'uso normale non devi installarlo nel progetto applicativo con npm i @truescreen/mcp.
• Il nome del pacchetto locale e @truescreen/mcp.
• Il client avvia il processo per te; non devi eseguire manualmente un demone separato.
• Puoi configurare nello stesso client MCP sia il server remoto sia quello locale.

Usa MCP remoto quando vuoi la configurazione più rapida e il tuo workflow non deve caricare file.

Usa MCP locale quando vuoi:

• creare certificazioni file partendo da documenti locali,
• caricare allegati per un True Flow,
• tenere nello stesso client MCP sia le operazioni testuali sia quelle con upload.

• Certificazione - Panoramica
• Flusso di chiamate Certificazione
• Flusso di chiamate True Flow