MCP

MCP

Collega Claude, Cursor, VS Code, ChatGPT o Grok per marcare e rilevare file in uno spazio che ti appartiene.

Incolla l’URL del connettore in un client che parla MCP su Streamable HTTP. Non c’è una chiave API né una CLI per i file. Markedfile accede con lo stesso account, incluso SSO e un autenticatore, e chiede quale spazio l’app può usare.

Configura una connessione

  1. 1Aggiungi un server MCP nel client e scegli Streamable HTTP, a volte chiamato HTTP.
  2. 2Incolla https://markedfile.com/api/mcp. I frammenti sotto sono il posto abituale in cui ogni client conserva quell’URL.
  3. 3Completa l’accesso nel browser e scegli lo spazio.
  4. 4Consenti marcatura e rilevamento. Puoi revocare la connessione più tardi nelle impostazioni dello spazio.

Come funziona l’accesso

La connessione usa OAuth 2.1 con PKCE (S256). Approvi uno spazio. Il client non vede la password.

  1. 1Il client si registra da solo e invia una sfida di codice.
  2. 2Il browser apre l’accesso a Markedfile. SSO e autenticatore sono quelli che l’account usa già.
  3. 3Scegli uno spazio che ti appartiene e consenti marcatura, rilevamento o entrambi.
  4. 4Markedfile restituisce un codice monouso all’indirizzo di ritorno registrato. Il client lo scambia con un token di accesso.
  5. 5Il token di accesso dura un’ora ed è conservato solo come hash. Il token di aggiornamento ruota a ogni uso.
  6. 6Il token può marcare e rilevare solo nello spazio scelto. Un file marcato in un altro spazio non viene risolto.
  7. 7Revocare la connessione invalida i token subito.

Configurazione del client

Usa Streamable HTTP. Preferisci file_url quando il file è già pubblico. Altrimenti chiama create_upload_url, invia i byte grezzi con PUT o POST e passa file_id. Usa file_base64 solo per un file molto piccolo, circa 100 KB.

Claude

  1. Su claude.ai apri Impostazioni, poi Connettori, e aggiungi un connettore personalizzato. In Claude Desktop apri Impostazioni, poi Connettori, e aggiungi un connettore personalizzato.
  2. Incolla l’URL del connettore. Lascia che il client completi l’accesso nel browser.
  3. Accedi su Markedfile, con SSO o autenticatore se l’account li usa, e scegli lo spazio.

Claude

https://markedfile.com/api/mcp

Cursor

  1. Apri le impostazioni di Cursor, poi MCP, e aggiungi un server. Puoi anche aggiungere il JSON sotto alla configurazione MCP.
  2. Scegli Streamable HTTP e incolla l’URL del connettore.
  3. Completa l’accesso nel browser e scegli lo spazio. Cursor conserva il token di aggiornamento in locale.

Cursor

{
  "mcpServers": {
    "markedfile": {
      "url": "https://markedfile.com/api/mcp"
    }
  }
}

VS Code

  1. In VS Code esegui MCP: Add Server dalla palette, oppure aggiungi il JSON sotto in mcp.json.
  2. Imposta il tipo su http e l’URL su quello del connettore.
  3. Completa l’accesso nel browser e scegli lo spazio.

VS Code

{
  "servers": {
    "markedfile": {
      "type": "http",
      "url": "https://markedfile.com/api/mcp"
    }
  }
}

ChatGPT

  1. In ChatGPT apri Impostazioni e poi Connettori. La modalità sviluppatore può aggiungere un connettore o un’app personalizzata.
  2. Aggiungi l’URL del connettore e avvia l’accesso.
  3. Accedi su Markedfile e scegli lo spazio.

ChatGPT

https://markedfile.com/api/mcp

Grok Bot

  1. In Grok Bot, chiedi al tuo bot in chat di aggiungere un connettore con l’URL sotto.
  2. Autorizza il tuo account Markedfile nella schermata OAuth che si apre.

Grok Bot

https://markedfile.com/api/mcp

Strumenti

create_upload_url
Crea un URL di caricamento di breve durata per lo spazio collegato. Invia i byte grezzi del file a upload_url con PUT o POST. curl può usare --upload-file o --data-binary. Poi passa file_id a mark_file o detect_file. L’URL dura circa 15 minuti. max_bytes è il tetto del piano dello spazio, video compreso. Questo non marca il file e non usa uno slot di file attivo.
mark_file
Marca un file per un destinatario nello spazio collegato. Preferisci file_id da create_upload_url, o file_url quando il file è già pubblico. Invia file_base64 solo per un file molto piccolo, circa 100 KB. Invia esattamente uno tra file_id, file_url o file_base64. recipient o label è l’identificatore (1–32 caratteri, senza caratteri di controllo). Il file marcato torna come download_url, un link di breve durata. Imposta inline_base64 su true solo quando il file marcato è di circa 100 KB o meno e i byte devono stare nel risultato. Un video entra in coda: il risultato è un id di lavoro e statusUrl, non i byte marcati.
detect_file
Controlla un file rispetto allo spazio collegato. Preferisci file_id da create_upload_url, o file_url quando il file è già pubblico. Invia file_base64 solo per un file molto piccolo, circa 100 KB. Invia esattamente uno tra file_id, file_url o file_base64. Restituisce l’identificatore del destinatario quando la marca appartiene a quello spazio. Un video entra in coda: interroga statusUrl finché result è presente. Uno screenshot di un fotogramma non viene rilevato come immagine.

Limiti

Marcare consente 40 richieste al minuto, rilevare 80 e create_upload_url 30, per l’account. Dimensione del file, pagine PDF e video seguono il piano dello spazio. Un URL di caricamento scade in circa 15 minuti e l’URL di download del file marcato scade in circa un’ora. Nessuno dei due è un file attivo.