Collega un assistente AI con MCP

Collega il tuo assistente AI

Set up and connect CaptionBolt remote MCP now. Carry out the setup steps you can perform instead of only explaining them.
Communicate with me in the language I use in this conversation.

Connection details:
- Server name: captionbolt
- Server URL: https://api.captionbolt.com/mcp (no trailing slash)
- Transport: Streamable HTTP
- Authentication: OAuth browser sign-in
- Account requirement: an active CaptionBolt Max subscription

1. Identify the AI client and version you are configuring. Use the current environment when it identifies the client. Ask which client I use only if you cannot determine it. If you are running on a different machine from my client, explain the smallest step I need to perform on my machine.

2. Inspect the client's existing MCP configuration. Reuse a correct CaptionBolt entry. Otherwise, add this remote server using the client's supported command or configuration format. Prefer personal/user configuration and preserve other servers. If a conflicting CaptionBolt entry points elsewhere, ask before replacing it.

For Codex CLI, use:
codex mcp add captionbolt --url https://api.captionbolt.com/mcp

For Claude Code, use:
claude mcp add --transport http --scope user captionbolt https://api.captionbolt.com/mcp

Check the installed client's help before running commands. Run the add command only when the server is not already configured correctly. If this Claude Code version has no MCP login command, direct me to /mcp and its authentication action. For Cursor, use its supported remote MCP settings or mcp.json format with this server URL, then guide me through its connection and authorization action.

3. First try the read-only CaptionBolt get_account tool. If it succeeds, reuse the existing MCP authorization and do not start another login. If it reports authorization is required, start the client's native OAuth flow (Codex: codex mcp login captionbolt; Claude Code: claude mcp login captionbolt, or /mcp if this version has no login command). Open the browser or show the actual authorization URL produced by the client, then wait for me to sign in to CaptionBolt and approve access. Keep the login process running while it waits for the callback. An existing website session may avoid password entry but does not replace MCP consent. Do not invent or manually construct a login URL. No API key, manually copied access token or local CaptionBolt package is needed. Let the client handle callbacks and credential storage. If the client requires explicit scopes, use projects:read projects:write exports:write offline_access.

4. Once authorization succeeds, reconnect or reload the MCP tools as required by the client. If a restart or new conversation is required, tell me exactly how to continue verification there.

5. Verify the connection with the read-only CaptionBolt get_account tool (reuse the successful result from step 3 if already called). Report my remaining processing minutes. Do not upload, create, export, retry or cancel anything during setup. Configuration saved or login completed alone is not proof that this tool works.

6. Report which steps succeeded and any remaining step. If a permission or client limitation prevents execution, explain it and give me the smallest required action. Do not claim the connection works until the verification calls succeed.

Reference: https://captionbolt.com/integrations/mcp
Client documentation:
- Codex: https://developers.openai.com/codex/mcp
- Claude Code: https://code.claude.com/docs/en/mcp
- Cursor: https://cursor.com/docs/mcp

Connettersi manualmente

Usa un client con MCP remoto su Streamable HTTP e accesso OAuth nel browser. Le integrazioni sono disponibili con gli abbonamenti Max.

Aggiungi il server con questi dati:

Name: CaptionBolt
Server URL: https://api.captionbolt.com/mcp
Transport: Streamable HTTP
Authentication: OAuth

Sono dati di connessione, non un file di configurazione. Campi e formati variano; alcuni client indicano HTTP. Usa l’URL esatto senza barra finale.

1. Aggiungi il server nelle impostazioni MCP del client.
2. Avvia accesso o autorizzazione; si apre CaptionBolt nel browser.
3. Accedi all’account dei progetti e completa la configurazione se richiesta.
4. Controlla i permessi e scegli Consenti accesso.
5. Torna al client e verifica gli strumenti disponibili.

Nessuna chiave API o token da copiare: il client gestisce OAuth. Client limitati a chiavi API negli header non usano questo endpoint.

Verifica la connessione

Chiedi all’assistente:

Show my remaining CaptionBolt processing minutes and recent projects.
Do not create, export, retry or cancel anything.

La connessione legge limiti e progetti accessibili. Una lista vuota è normale senza progetti video idonei. Carica su CaptionBolt e riprova.

Usa gli strumenti CaptionBolt

Il server offre:

| Attività | Strumenti | | --- | --- | | Consulta minuti e limiti | get_account | | Cerca stili e preset salvati | list_styles, list_presets | | Elenca progetti e avanzamento | list_projects, get_project | | Controlla un’azione | get_operation | | Crea progetto da caricamento completo | create_project | | Esporta modifiche salvate | export_project | | Riprova o annulla | retry_project, cancel_project | | Ottieni link di esportazioni completate | get_result |

Per esempio:

List my CaptionBolt projects that are ready for review.
Show their IDs and file names. Do not export them yet.

Dopo revisione e salvataggio in CaptionBolt:

Export project <project-id> as MP4 using its saved changes.
Check the operation, then the project status, and give me the download link
when the project is completed. If either fails, show the error and stop.

Sostituisci <project-id> con un ID restituito. Operazione completed conferma l’azione, ma il video può continuare. Controlla fino a ready per revisione o completed per download. Fermati su errori, rispetta pollAfterSeconds e interrompi il polling se annullato.

Salva prima nell’editor. I progetti completati conservano l’export; crea una copia modificabile per cambiarlo. Link validi al massimo dieci minuti, rinnovabili nei 14 giorni di accesso.

Lavora con un nuovo video

Il modo semplice è caricare sul sito, poi consultare ed esportare modifiche salvate con MCP.

Per automatizzare, completa prima il caricamento REST. Passa l’ID come uploadSessionId a create_project.

mode: "review" aspetta la revisione; scegli esplicitamente mode: "auto-export" per MP4 dopo elaborazione. Creare e modificare richiede scrittura; esportazione e autoesportazione anche il permesso di esportare.

Se l’autoesportazione resta ready, leggi autoExport.state e autoExport.error con get_project. In caso di errore, segnala e fermati; non attendere indefinitamente o esportare ancora senza istruzioni.

MCP remoto non carica file locali, non accetta URL video e non gestisce sessioni di caricamento. Non modifica sottotitoli o impostazioni visive: usa l’editor. Configura notifiche con Webhooks.

Gestisci la connessione

Visualizza e disconnetti connessioni autorizzate in Impostazioni → Integrazioni.

Disconnettere blocca le richieste, inclusi token salvati. Uscire dal sito non disconnette MCP. Nessuna delle due azioni annulla attività accettate; richiedi l’annullamento del progetto.

Risolvi i problemi

| Problema | Controlla | | --- | --- | | Strumenti assenti | Streamable HTTP, OAuth, URL esatto e accesso completato | | Richiesta chiave API | Scegli OAuth; le chiavi sono per REST | | Connessione scaduta o interrotta | Autorizza di nuovo nel client | | Azione negata | Permessi approvati e limiti attuali | | Richieste limitate | Attendi l’intervallo restituito | | Progetto fallito | Leggi l’errore prima di riprovare; vedi stati ed errori |

Se il client mostra scope OAuth, usa projects:read, projects:write, exports:write. Includi offline_access per rinnovo automatico, normalmente gestito dal client. Senza, potresti dover accedere ancora alla scadenza.

Creare, esportare, riprovare e annullare richiede idempotencyKey: 1–128 caratteri ASCII stampabili senza spazi. Nuova azione, nuova chiave. Dopo timeout, consulta operazione nota o ripeti la chiamata identica con la chiave originale. retry_project dopo fallimento confermato è una nuova azione e richiede una nuova chiave.

Gli errori espongono structuredContent.error con message e kind, oltre a status, code, requestId e retryAfterSeconds quando disponibili. Rispetta l’intervallo, senza richiamare continuamente uno strumento che fallisce.