{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/it/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Integrazione MCP","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"integrazione-mcp","__idx":0},"children":["Integrazione MCP"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["TrueScreen espone ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["due server MCP"]},":"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["un ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["server MCP remoto"]}," per operazioni testuali e JSON,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["un ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["server MCP locale"]}," per le stesse operazioni più le procedure che richiedono upload di file dalla tua macchina."]}]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"flowchart LR\n Client[Client AI]\n Remote[Server MCP remoto]\n Local[Server MCP locale]\n API[TrueScreen Public API]\n Files[Filesystem locale]\n\n Client --> Remote\n Client --> Local\n Remote --> API\n Local --> API\n Local --> Files\n","diagramHtml":"

Client AI

Server MCP remoto

Server MCP locale

TrueScreen Public API

Filesystem locale

","diagramHtmlDark":"

Client AI

Server MCP remoto

Server MCP locale

TrueScreen Public API

Filesystem locale

"},"children":["flowchart LR\n Client[Client AI]\n Remote[Server MCP remoto]\n Local[Server MCP locale]\n API[TrueScreen Public API]\n Files[Filesystem locale]\n\n Client --> Remote\n Client --> Local\n Remote --> API\n Local --> API\n Local --> Files\n"]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"scegliere-il-server-corretto","__idx":1},"children":["Scegliere il server corretto"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Caso d'uso"},"children":["Caso d'uso"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"MCP remoto"},"children":["MCP remoto"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"MCP locale"},"children":["MCP locale"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ottenere i crediti"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sì"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sì"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Elencare i template disponibili"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sì"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sì"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Creare un True Flow senza upload locale di file"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sì"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sì"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Creare una certificazione hash"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sì"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sì"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Creare una certificazione dati"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sì"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sì"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Consultare lo stato di una certificazione"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sì"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sì"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Attendere il completamento di una certificazione"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sì"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sì"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Creare una certificazione file partendo da file su disco"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sì"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Caricare un allegato True Flow partendo da file su disco"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sì"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In pratica:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["usa il ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["server MCP remoto"]}," quando il workflow e interamente basato su testo o JSON;"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["usa il ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["server MCP locale"]}," quando il workflow include un file da leggere dalla tua macchina e caricare."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"cosa-può-fare-ciascun-server","__idx":2},"children":["Cosa può fare ciascun server"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"disponibile-su-entrambi-i-server-mcp","__idx":3},"children":["Disponibile su entrambi i server MCP"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Questi tool sono disponibili sia sul server remoto sia su quello locale:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["truescreen_get_credits"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["truescreen_list_templates"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["truescreen_create_true_flow"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["truescreen_create_hash_certification"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["truescreen_create_data_certification"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["truescreen_get_certification"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["truescreen_wait_for_certification"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"disponibile-solo-sul-server-mcp-locale","__idx":4},"children":["Disponibile solo sul server MCP locale"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Questi tool sono disponibili solo sul server locale:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["truescreen_create_file_certification_attachments"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["truescreen_upload_file"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["truescreen_create_file_certification"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["truescreen_create_true_flow_attachment"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Usa il server locale quando ti serve:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["la ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["certificazione file"]},", perche il flusso include l'upload di file,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["l'",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["upload di allegati True Flow"]},", perche il file deve essere letto localmente prima del caricamento."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"mappatura-mcp---rest","__idx":5},"children":["Mappatura MCP -> REST"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tool MCP"},"children":["Tool MCP"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Chiamata REST"},"children":["Chiamata REST"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Documentazione REST"},"children":["Documentazione REST"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["truescreen_get_credits"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v1/credits"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/certification-overview#crediti"},"children":["Certificazione - Panoramica - Crediti"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["truescreen_list_templates"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v1/templates"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/true-flow-workflow#flow-template-token"},"children":["Flusso di chiamate True Flow - Flow template token"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["truescreen_create_true_flow"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/true-flows"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/true-flow-workflow#casi-duso"},"children":["Flusso di chiamate True Flow - Casi d'uso"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["truescreen_create_hash_certification"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/hash-certifications"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/certification-workflow#1-certificazione-hash"},"children":["Flusso di chiamate Certificazione - Certificazione hash"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["truescreen_create_data_certification"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/data-certifications"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/certification-workflow#2-certificazione-dati"},"children":["Flusso di chiamate Certificazione - Certificazione dati"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["truescreen_get_certification"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v1/certifications/{reportId}"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/certification-workflow#4-consultare-lo-stato-della-certificazione"},"children":["Flusso di chiamate Certificazione - Consultare lo stato della certificazione"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["truescreen_wait_for_certification"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Polling su ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v1/certifications/{reportId}"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/certification-overview#processo-asincrono"},"children":["Certificazione - Panoramica - Processo asincrono"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["truescreen_create_file_certification_attachments"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/file-certifications-attachments"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/certification-workflow#3-certificazione-file"},"children":["Flusso di chiamate Certificazione - Certificazione file"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["truescreen_upload_file"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PUT upload_url"]}," sull'URL presigned restituito dall'API"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/certification-workflow#passo-2-caricare-i-file"},"children":["Flusso di chiamate Certificazione - Passo 2 caricare i file"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["truescreen_create_file_certification"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/file-certifications"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/certification-workflow#3-certificazione-file"},"children":["Flusso di chiamate Certificazione - Certificazione file"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["truescreen_create_true_flow_attachment"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/true-flows-attachments"]}," e ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PUT upload_url"]}," prima di ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/true-flows"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/true-flow-workflow#3-creazione-true-flow-con-allegati"},"children":["Flusso di chiamate True Flow - Creazione True Flow con allegati"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Se ti serve il contratto a livello di schema per una di queste chiamate, usa anche la ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/openapi"},"children":["specifica OpenAPI"]}," insieme alle guide operative."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"installare-il-server-mcp-remoto","__idx":6},"children":["Installare il server MCP remoto"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"requisiti","__idx":7},"children":["Requisiti"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Una API key TrueScreen valida"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Un client MCP che supporti ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Streamable HTTP"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"esempio-cursor","__idx":8},"children":["Esempio Cursor"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Aggiungi questo al tuo ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mcp.json"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"mcpServers\": {\n \"truescreen\": {\n \"url\": \"https://mcp.truescreen.app/mcp\",\n \"headers\": {\n \"Authorization\": \"Bearer abc...\"\n }\n }\n }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"note","__idx":9},"children":["Note"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["La API key viene inviata nell'header ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization"]}," come token Bearer."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Non e richiesto alcun processo locale Node.js."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Qualsiasi client MCP con configurazione equivalente di URL e header può usare lo stesso server remoto."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"installare-il-server-mcp-locale","__idx":10},"children":["Installare il server MCP locale"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Il server locale gira come processo Node.js sulla tua macchina. E la scelta corretta quando il workflow richiede file presenti su disco."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"requisiti-1","__idx":11},"children":["Requisiti"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Una API key TrueScreen valida"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Node.js 20 o successivo"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"esempio-cursor-1","__idx":12},"children":["Esempio Cursor"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Aggiungi questo al tuo ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mcp.json"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"mcpServers\": {\n \"truescreen-local\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@truescreen/mcp\"],\n \"env\": {\n \"TRUESCREEN_API_KEY\": \"abc...\"\n }\n }\n }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"selezione-opzionale-dellambiente","__idx":13},"children":["Selezione opzionale dell'ambiente"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Se ti serve un ambiente non di produzione, puoi impostare anche ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MCP_ENV"]}," a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["stg"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"mcpServers\": {\n \"truescreen-local\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@truescreen/mcp\"],\n \"env\": {\n \"TRUESCREEN_API_KEY\": \"abc...\",\n \"MCP_ENV\": \"stg\"\n }\n }\n }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"note-1","__idx":14},"children":["Note"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Usa il server locale come pacchetto eseguito dal client MCP, tipicamente con ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["npx -y @truescreen/mcp"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Nell'uso normale non devi installarlo nel progetto applicativo con ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["npm i @truescreen/mcp"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Il nome del pacchetto locale e ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["@truescreen/mcp"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Il client avvia il processo per te; non devi eseguire manualmente un demone separato."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Puoi configurare nello stesso client MCP sia il server remoto sia quello locale."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"scelta-tipica","__idx":15},"children":["Scelta tipica"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Usa ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["MCP remoto"]}," quando vuoi la configurazione più rapida e il tuo workflow non deve caricare file."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Usa ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["MCP locale"]}," quando vuoi:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["creare certificazioni file partendo da documenti locali,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["caricare allegati per un True Flow,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["tenere nello stesso client MCP sia le operazioni testuali sia quelle con upload."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"guide-collegate","__idx":16},"children":["Guide collegate"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/certification-overview"},"children":["Certificazione - Panoramica"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/certification-workflow"},"children":["Flusso di chiamate Certificazione"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/true-flow-workflow"},"children":["Flusso di chiamate True Flow"]}]}]}]},"headings":[{"value":"Integrazione MCP","id":"integrazione-mcp","depth":1},{"value":"Scegliere il server corretto","id":"scegliere-il-server-corretto","depth":2},{"value":"Cosa può fare ciascun server","id":"cosa-può-fare-ciascun-server","depth":2},{"value":"Disponibile su entrambi i server MCP","id":"disponibile-su-entrambi-i-server-mcp","depth":3},{"value":"Disponibile solo sul server MCP locale","id":"disponibile-solo-sul-server-mcp-locale","depth":3},{"value":"Mappatura MCP -> REST","id":"mappatura-mcp---rest","depth":2},{"value":"Installare il server MCP remoto","id":"installare-il-server-mcp-remoto","depth":2},{"value":"Requisiti","id":"requisiti","depth":3},{"value":"Esempio Cursor","id":"esempio-cursor","depth":3},{"value":"Note","id":"note","depth":3},{"value":"Installare il server MCP locale","id":"installare-il-server-mcp-locale","depth":2},{"value":"Requisiti","id":"requisiti-1","depth":3},{"value":"Esempio Cursor","id":"esempio-cursor-1","depth":3},{"value":"Selezione opzionale dell'ambiente","id":"selezione-opzionale-dellambiente","depth":3},{"value":"Note","id":"note-1","depth":3},{"value":"Scelta tipica","id":"scelta-tipica","depth":2},{"value":"Guide collegate","id":"guide-collegate","depth":2}],"frontmatter":{"title":"Integrazione MCP","description":"Usa i server MCP di TrueScreen, scegli il canale corretto e installa la configurazione remota o locale","seo":{"title":"Integrazione MCP"}},"lastModified":"2026-06-25T16:08:49.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/it/mcp-integration","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}