DeepScript

Integración

Servidor MCP – los agentes de IA leen tus transcripciones directamente

Claude Desktop, Cursor, Zed y otros clientes MCP hablan directamente con tu biblioteca de DeepScript. Sin copiar y pegar, sin nube de terceros.

En lugar de crear nuestros propios endpoints de resumen, traducción o búsqueda, DeepScript ofrece un servidor MCP completo. Los clientes de IA como Claude Desktop, Claude Code o Cursor se conectan mediante Bearer auth a `https://mcp.deepscript.com` y pueden entonces buscar en tus transcripciones, recuperar una o resumirlas – con el LLM que prefieran. Se exponen tres herramientas: `search_transcripts` (búsqueda de texto completo en tu biblioteca), `get_transcript` (contenido completo de la transcripción, incluidas las marcas de tiempo por palabra) y `list_recent` (las últimas N transcripciones). El servidor MCP forma parte del plan Pro (22 €/mes) porque elimina la retención predeterminada de 30 días y desbloquea tráfico de agentes ilimitado. Los tokens de autenticación son las mismas claves API `ds_live_` que usa la API REST.

Lo que puedes crear

  • Pregunta a Claude en la app de escritorio: «¿Cómo se llamaba el proveedor en la reunión de la semana pasada?» – y Claude busca en tus transcripciones.
  • Haz que tu agente en el IDE resuma episodios de podcast sin copiarlos.
  • Extrae citas de entrevistas mediante el agente y escríbelas en notas Markdown (p. ej. en Cursor o Zed).
  • Auditorías de cumplimiento: haz que el agente compruebe si determinados términos aparecieron en reuniones archivadas.
  • Investigación entre grabaciones: «Encuentra todas las reuniones en las que se habló del Proyecto X.»

Ejemplos de código

Claude Desktop – claude_desktop_config.jsonJSON
{
  "mcpServers": {
    "deepscript": {
      "type": "http",
      "url": "https://mcp.deepscript.com",
      "headers": {
        "Authorization": "Bearer ds_live_xxx"
      }
    }
  }
}
Cursor / Zed – mcp.jsonJSON
{
  "servers": {
    "deepscript": {
      "transport": "http",
      "url": "https://mcp.deepscript.com",
      "auth": {
        "type": "bearer",
        "token": "ds_live_xxx"
      }
    }
  }
}
Esquema de herramientas (expuesto por el servidor)JSON
{
  "tools": [
    {
      "name": "search_transcripts",
      "description": "Full-text search across the user's transcript library. Returns the top N hits with snippet, transcriptId and createdAt.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "query": { "type": "string" },
          "limit": { "type": "integer", "default": 10, "maximum": 50 }
        },
        "required": ["query"]
      }
    },
    {
      "name": "get_transcript",
      "description": "Return the full text and word-level metadata for one transcription.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "transcriptId": { "type": "string", "format": "uuid" },
          "includeWords": { "type": "boolean", "default": false }
        },
        "required": ["transcriptId"]
      }
    },
    {
      "name": "list_recent",
      "description": "List the N most recent transcriptions with filename, duration and createdAt.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "limit": { "type": "integer", "default": 20, "maximum": 100 }
        }
      }
    }
  ]
}

Configuración en pocos pasos

  1. 1

    Activar el plan Pro

    El servidor MCP es exclusivo del plan Pro (22 €/mes). Mejóralo en el panel de facturación. Pro elimina al mismo tiempo el borrado automático a los 30 días, lo que permite a tu agente buscar también en transcripciones más antiguas.

  2. 2

    Usar una clave API como token Bearer

    Genera una clave `ds_live_` normal en el panel. La misma clave autentica las llamadas MCP y REST. Recomendación: crea una clave MCP dedicada con su propia etiqueta para poder revocarla de forma aislada.

  3. 3

    Configurar tu cliente MCP

    Añade la entrada de servidor mostrada arriba en Claude Desktop, Cursor o Zed. Reinicia el cliente. Las tres herramientas `search_transcripts`, `get_transcript` y `list_recent` aparecen automáticamente en el selector de herramientas.

  4. 4

    Úsalo en el chat

    Habla con el agente en lenguaje natural. Elige la herramienta adecuada por sí mismo. Ejemplo: «Busca en mis transcripciones cualquier mención de 'previsión Q3'.» – el agente llama a `search_transcripts({ query: 'Q3 forecast' })`.

Preguntas frecuentes

¿Por qué MCP es exclusivo del plan Pro?

Los agentes suelen realizar muchas consultas por conversación y necesitan acceso a transcripciones más antiguas. Pro elimina la retención predeterminada de 30 días y exime las llamadas MCP del límite de tasa habitual. Para un uso ocasional, el endpoint REST en modo pay-per-use es suficiente.

¿Qué transportes admite el servidor?

Actualmente el transporte HTTP (Server-Sent Events para respuestas en streaming). stdio no se admite porque el servidor se ejecuta de forma remota. La mayoría de los clientes (Claude Desktop desde la versión 0.7, Cursor, Zed) admiten MCP HTTP de fábrica.

¿Ven mis transcripciones los proveedores de IA?

Sí – en cuanto tu agente local carga una transcripción mediante `get_transcript`, la envía como contexto al LLM (p. ej. Anthropic, OpenAI). Para evitarlo, ejecuta un cliente LLM local (p. ej. Ollama mediante el adaptador de Claude Code) combinado con DeepScript MCP – así los datos solo residen en tu máquina y en nuestro servidor alemán.

¿Cuál es la disponibilidad del servidor MCP?

El servidor MCP se ejecuta en el mismo clúster de Hetzner que la API REST, con nuestro SLA habitual del 99,9 %. El estado y los incidentes están en deepscript.com/status. Ante una caída, el agente falla de forma controlada – las llamadas a herramientas devuelven un mensaje de error claro.

¿Puedo llamar a las herramientas MCP yo mismo, sin un cliente de IA?

Técnicamente sí – MCP es un protocolo JSON-RPC abierto, puedes invocar las herramientas mediante HTTP/curl. Para integraciones puramente servidor a servidor, la API REST normal es más práctica, ya que está tipada con OpenAPI y no está orientada a agentes.

¿Listo para llevarlo a producción?

Crea una cuenta, genera una clave API y a producir. Tres transcripciones gratis para probar. Documentación OpenAPI 3.1 completa en api.deepscript.com/docs.

Servidor MCP para transcripciones – acceso Claude & ChatGPT | DeepScript