Speak AI

Conecta Speak AI a Claude o ChatGPT en 60 segundos

Para investigadores, equipos de ingresos, equipos con muchas reuniones y flujos de trabajo de medios.
Sin Terminal. Sin npm. Sin archivos de configuración JSON.

Guía de instalación en docs.speakai.co/mcp →

Qué hace esto

Speak AI transcribe tus entrevistas, llamadas de ventas, sesiones de investigación, seminarios web, podcasts y reuniones de equipo — y luego extrae información de IA como resúmenes, elementos de acción, sentimiento y temas.

Este conector (construido sobre MCP — el estándar para que Claude y ChatGPT se conecten a aplicaciones) trae todo eso a Claude o ChatGPT. Una vez instalado, puedes preguntar:

• "Encuentra las últimas 10 entrevistas de clientes que mencionen precios, agrupa los comentarios por tema y cita las grabaciones de origen."
• "Resume las reuniones de equipo de esta semana en decisiones, elementos de acción, responsables y riesgos no resueltos."
• "Extrae citas exactas de clientes sobre la fricción en la incorporación de llamadas de investigación recientes y formatéalas para un informe de producto."
• "Encuentra un momento destacado de 30 segundos del último seminario web, crea un clip y exporta los subtítulos."

La IA hace la búsqueda, el resumen y las citas. Tus grabaciones permanecen en tu espacio de trabajo de Speak AI — Claude y ChatGPT solo las consultan a través de este conector.

Instalación (elige tu herramienta)

Dos formas de instalar — elige la que te resulte más fácil. La ruta de conexión con un clic aprueba el acceso mediante una ventana emergente de permisos; la ruta manual pega una clave de API en un encabezado.

¿No sabes cuál elegir? Si ya usas Claude o ChatGPT, instala para el que tengas.

Dirección del conector de Speak AI (pégalo en la configuración de conectores de tu herramienta de IA — es la misma idea que pegar un enlace de Zoom en tu calendario): https://api.speakai.co/v1/mcp

Claude.ai (web)

1. Abre claude.ai/settings/connectors
2. Haz clic en Añadir conector personalizado
3. Nómbralo Speak AI y pega https://api.speakai.co/v1/mcp, luego haz clic en Añadir
4. Una ventana emergente de permisos te pide iniciar sesión en Speak AI y hacer clic en Permitir
5. Listo — Speak AI aparece en tu lista de conectores con sus herramientas listas para usar. Abre un nuevo chat y pregunta sobre tus grabaciones.

Claude Desktop

1. Abre Claude Desktop → Configuración → Conectores → Añadir conector personalizado
2. Pega https://api.speakai.co/v1/mcp
3. Haz clic en Añadir — se abre una ventana emergente de permisos. Inicia sesión en Speak AI y haz clic en Permitir en la pantalla que aparece.
4. Listo.

ChatGPT

1. Abre ChatGPT → Configuración → Apps y conectores → Avanzado
2. Activa Modo desarrollador (requerido mientras Speak AI no esté aún en la tienda de aplicaciones de ChatGPT — esto te permite añadirlo como aplicación personalizada)
3. De vuelta en Apps y conectores, haz clic en Crear y pega https://api.speakai.co/v1/mcp
4. Para Autenticación, elige OAuth
5. ChatGPT abre una nueva pestaña a Speak AI — inicia sesión (o haz clic en Confirmar si ya has iniciado sesión) para autorizar. Serás redirigido de vuelta; cierra la pestaña y regresa a ChatGPT.
6. Por chat: abre un chat, haz clic en el menú + / de conectores y habilita Speak AI para ese chat.

Claude Code (terminal)

Recomendado — instala desde el mercado oficial de plugins de Claude Code:

1. Añade el mercado oficial (una sola vez): /plugin marketplace add claude-plugins-official
2. Instala el plugin: /plugin install speakai@claude-plugins-official
3. Actívalo: /reload-plugins
4. Ejecuta la habilidad getting-started y pega tu clave de API de Speak AI. Genera una en app.speakai.co/developers/apikeys.

Si /plugin install no encuentra Speak AI, actualiza el catálogo local con /plugin marketplace update claude-plugins-official y vuelve a intentarlo.

claude mcp add speakai --transport http --url https://api.speakai.co/v1/mcp

claude mcp add speakai --transport http --url https://api.speakai.co/v1/mcp \
  --header "Authorization: Bearer $SPEAKAI_KEY"

Cursor

Haz clic en el botón — Cursor se registra automáticamente y abre la ventana emergente de permisos. Inicia sesión en Speak AI y haz clic en Permitir.

VS Code

Haz clic en el botón — VS Code se registra automáticamente y abre la ventana emergente de permisos. Inicia sesión en Speak AI y haz clic en Permitir.

OpenClaw / ClawHub

Speak AI está publicado como una habilidad en ClawHub para agentes compatibles con OpenClaw.

1. Visita la página de la habilidad Speak AI en ClawHub
2. Sigue las instrucciones de instalación para tu agente — por ejemplo, clawhub install speakai desde la CLI de ClawHub
3. Configura tu variable de entorno SPEAK_API_KEY. Genera una en app.speakai.co/developers/apikeys.

ChatGPT (API / Responses)

Para desarrolladores que llaman a la API de Responses directamente. Pasa el token bearer en la configuración de la herramienta:

{
  "tools": [
    {
      "type": "mcp",
      "server_url": "https://api.speakai.co/v1/mcp",
      "authorization": "Bearer YOUR_SPEAK_API_KEY"
    }
  ]
}

Obtén una clave en app.speakai.co/developers/apikeys.

Privacidad y datos

Cuando haces clic en Permitir en la ventana emergente de permisos (o pegas tu clave de API de Speak AI en Claude o ChatGPT), estás autorizando a ese asistente de IA a leer y modificar tu espacio de trabajo de Speak AI en tu nombre — incluidos archivos de medios, transcripciones e información de IA.

• Tus grabaciones permanecen en tu espacio de trabajo de Speak AI. No se copian ni almacenan en Anthropic u OpenAI.
• Claude/ChatGPT solo ven los datos específicos que tu asistente de IA solicita para la pregunta que hiciste.
• Puedes desconectarte en cualquier momento eliminando el conector dentro de Claude/ChatGPT, revocando la conexión en api.speakai.co/v1/oauth/connections, o rotando/revocando tu clave de API en app.speakai.co/developers/apikeys.

Para preguntas sobre el manejo de datos, consulta speakai.co/privacy o envía un correo a success@speakai.co.

¿Necesitas ayuda para conectarte?

No deberías necesitar ser técnico para instalar esto. Si algo es confuso o no funciona:

• Envía un correo a success@speakai.co — responderemos dentro de 24 horas
• Reserva una demostración con nosotros y lo configuraremos juntos

Lo que puedes hacer una vez instalado

Speak AI incluye 114 herramientas que tu asistente de IA puede llamar. No necesitas memorizarlas — Claude/ChatGPT eligen las correctas según lo que preguntes. Ejemplos por categoría:

El catálogo completo de herramientas está en la referencia para desarrolladores a continuación.

Referencia para desarrolladores (CLI, API, configuración avanzada)

El servidor MCP está en https://api.speakai.co/v1/mcp y admite dos métodos de autenticación:

1. OAuth 2.1 + Registro dinámico de clientes — instala pegando la URL anterior en cualquier cliente MCP y aprobando la ventana emergente de consentimiento. Los endpoints de descubrimiento, DCR, /authorize + consentimiento, /token y revocación están todos disponibles.
2. Token Bearer (tu clave de API de Speak AI — encabezado Authorization: Bearer <key>). Para clientes que no usan OAuth, además de la CLI de npm y el modo stdio.

Obtén una clave de API de Speak AI en app.speakai.co/developers/apikeys.

CLI / paquete npm

El paquete npm @speakai/mcp-server proporciona:

• Una CLI (speakai-mcp) para scripts y pipelines (30 comandos).
• Un servidor MCP en modo stdio para clientes que no admiten transporte HTTP remoto.
• Un asistente de configuración automática que detecta los clientes MCP instalados y los configura.

npm install -g @speakai/mcp-server
speakai-mcp init

Configuración manual (modo stdio)

{
  "mcpServers": {
    "speak-ai": {
      "command": "npx",
      "args": ["-y", "@speakai/mcp-server"],
      "env": {
        "SPEAK_API_KEY": "your-api-key"
      }
    }
  }
}

export SPEAK_API_KEY="your-api-key"
claude mcp add speak-ai -- npx -y @speakai/mcp-server

{
  "mcpServers": {
    "speak-ai": {
      "command": "npx",
      "args": ["-y", "@speakai/mcp-server"],
      "env": {
        "SPEAK_API_KEY": "your-api-key"
      }
    }
  }
}

{
  "mcpServers": {
    "speak-ai": {
      "command": "npx",
      "args": ["-y", "@speakai/mcp-server"],
      "env": {
        "SPEAK_API_KEY": "your-api-key"
      }
    }
  }
}

{
  "mcpServers": {
    "speak-ai": {
      "command": "npx",
      "args": ["-y", "@speakai/mcp-server"],
      "env": {
        "SPEAK_API_KEY": "your-api-key"
      }
    }
  }
}

SPEAK_API_KEY=your-key npx @speakai/mcp-server

Variables de entorno

Herramientas MCP (114)

Recursos MCP (5)

Los recursos proporcionan acceso directo a datos sin llamadas de herramientas. Los clientes pueden leer estos URIs directamente.

Prompts MCP (3)

Prompts de flujo de trabajo preconstruidos que los agentes pueden invocar para ejecutar tareas de múltiples pasos.

analyze-meeting

Sube una grabación y obtén un análisis completo — transcripción, información, elementos de acción y conclusiones clave.

Parameters: url (required), name (optional)

Ejemplo: "Usa el prompt analyze-meeting con url=https://example.com/standup.mp3"

research-across-media

Busca temas, patrones o tópicos en múltiples grabaciones o en toda tu biblioteca.

Parameters: topic (required), folder (optional)

Ejemplo: "Usa el prompt research-across-media con topic='customer churn reasons'"

meeting-brief

Prepara un resumen de reuniones recientes — extrae transcripciones, identifica decisiones y resume elementos pendientes.

Parameters: days (optional, default: 7), folder (optional)

Ejemplo: "Usa el prompt de resumen de reunión con days=14 para cubrir las últimas dos semanas"

CLI (30 comandos)

Instala globalmente y configura una vez:

npm install -g @speakai/mcp-server
speakai-mcp config set-key

O ejecuta sin instalar:

npx @speakai/mcp-server config set-key

Configuración

Gestión de medios

IA y búsqueda

Carpetas y clips

Espacio de trabajo

Opciones de CLI

Cada comando admite:

• --json — genera JSON sin procesar (para scripting y canalización)
• --help — muestra ayuda específica del comando

Ejemplos de CLI

# Upload and wait for processing
speakai-mcp upload https://example.com/interview.mp3 -n "Q1 Interview" --wait

# Upload a local file
speakai-mcp upload ./meeting-recording.mp4

# Get plain-text transcript
speakai-mcp transcript abc123 --plain > meeting.txt

# Export as PDF with speaker names
speakai-mcp export abc123 -f pdf --speakers

# Ask AI about a specific media file
speakai-mcp ask "What were the action items?" -m abc123

# Ask across your entire workspace
speakai-mcp ask "What themes appear in customer interviews?"

# Search all transcripts
speakai-mcp search "pricing concerns" --from 2026-01-01

# Create a text note from stdin
cat notes.txt | speakai-mcp create-text "Meeting Notes"

# Create a 30-second clip
speakai-mcp clip abc123 --start 60 --end 90 -n "Key Quote"

# Schedule a meeting bot
speakai-mcp schedule-meeting "https://zoom.us/j/123456" -t "Weekly Standup"

# List videos as JSON for scripting
speakai-mcp ls --type video --json | jq '.mediaList[].name'

# List media from the last week
speakai-mcp ls --from 2026-04-18 --to 2026-04-25

# Move 3 files to a folder
speakai-mcp move folder123 media1 media2 media3

Ejemplos de flujo de trabajo

Transcribe y analiza una reunión

You: "Upload and transcribe this recording: https://example.com/meeting.mp3"

AI: I'll upload that for you and start processing.
    → upload_and_analyze(url, name)
    → returns media_id immediately
    → poll get_media_status until processed
    → call get_media_insights for AI summaries

    Here's your transcript with 3 speakers identified.
    Key insights: 5 action items, positive sentiment overall.
    Top topics: Q2 roadmap, hiring plan, budget review.

Investiga en tu biblioteca

You: "What themes came up across all our customer interviews this month?"

AI: Let me search your media library.
    → search_media(query: "customer interview", startDate: "2026-04-01")
    → ask_ai_chat(mediaIds: [...], prompt: "What are the recurring themes?")

    Across 12 interviews, the top themes were:
    1. Pricing sensitivity (mentioned in 8/12)
    2. Onboarding friction (6/12)
    3. Feature requests for API access (5/12)

Automatización de reuniones

You: "Join my 2pm Zoom call, then send me a summary with action items"

AI: → schedule_meeting_event(meetingUrl, scheduledAt: "2026-04-25T14:00:00Z")

    Done. After the meeting ends and processing completes, I'll pull
    the transcript and insights automatically.

    [After the meeting]
    → get_media_insights(mediaId)
    → ask_ai_chat(mediaIds: [...], prompt: "List all action items with owners")

    Here's your meeting summary with 7 action items...

Crea un resumen semanal

You: "Prepare a brief from all meetings in the last week"

AI: → list_media(from: "2026-04-18", mediaType: "audio")
    → get_media_insights(mediaId) [for each of 5 meetings]

    Weekly Meeting Brief (Apr 18-25):
    - Engineering Standup: Deployed v2.3, 2 bugs triaged
    - Sales Review: Pipeline at $1.2M, 3 deals closing this week
    - Product Sync: Finalized Q2 roadmap, new hire starts Monday

    Consolidated Action Items: [12 items grouped by owner]

Autenticación (API REST)

El servidor MCP y la CLI gestionan los tokens automáticamente. Si llamas a la API REST directamente, este es el flujo de autenticación completo:

Paso 1 — Obtén un token de acceso:

curl -X POST https://api.speakai.co/v1/auth/accessToken \
  -H "Content-Type: application/json" \
  -H "x-speakai-key: YOUR_API_KEY"

Respuesta:

{
  "data": {
    "email": "you@example.com",
    "accessToken": "eyJhbG...",
    "refreshToken": "eyJhbG..."
  }
}

Paso 2 — Usa el token en todas las solicitudes posteriores:

curl https://api.speakai.co/v1/media \
  -H "x-speakai-key: YOUR_API_KEY" \
  -H "x-access-token: ACCESS_TOKEN_FROM_STEP_1"

Paso 3 — Renueva antes de que expire:

curl -X POST https://api.speakai.co/v1/auth/refreshToken \
  -H "Content-Type: application/json" \
  -H "x-speakai-key: YOUR_API_KEY" \
  -H "x-access-token: CURRENT_ACCESS_TOKEN" \
  -d '{"refreshToken": "REFRESH_TOKEN_FROM_STEP_1"}'

Duración de los tokens:

Límites de autenticación: 5 solicitudes por 30 segundos tanto en /v1/auth/accessToken como en /v1/auth/refreshToken.

Notas sobre el modelo de datos

• IDs de carpeta: Las carpetas tienen tanto _id (ObjectId de MongoDB) como folderId (cadena). Todas las operaciones de API usan folderId — este es el ID que debes pasar a list_media, upload_media, bulk_move_media y otros endpoints que aceptan un parámetro de carpeta.
• IDs de medios: Los elementos multimedia usan mediaId (devuelto en las respuestas de lista como _id).

Límites de velocidad y mejores prácticas

• El cliente MCP reintenta automáticamente en 429 con retroceso exponencial
• Para uso directo de la API, implementa retroceso exponencial y respeta los encabezados Retry-After
• Almacena en caché datos estables (listas de carpetas, definiciones de campos, idiomas compatibles)
• Usa export_multiple_media en lugar de exportaciones individuales para operaciones por lotes
• Usa bulk_move_media para mover varios elementos a la vez en lugar de actualizar uno por uno
• Usa bulk_update_transcript_speakers para renombrar hablantes en muchos archivos con una sola llamada
• Usa list_media con include: ["transcription"] para obtener medios con transcripciones integradas, evitando llamadas N+1 a get_transcript

Formato de error

Todos los errores de herramientas siguen esta estructura:

{
  "content": [{ "type": "text", "text": "Error: HTTP 401: Invalid API key" }],
  "isError": true
}

Desarrollo

git clone https://github.com/speakai/speakai-mcp.git
cd speakai-mcp

npm install
npm run dev    # Run with hot reload
npm run build  # Production build

Recursos

• docs.speakai.co/mcp — tutorial de instalación con capturas de pantalla y video
• Plataforma Speak AI — producto principal
• Documentación de la API
• Protocolo MCP
• Entrada del registro MCP — descubrimiento oficial
• llms.txt — guía para asistentes de IA que ayudan a los usuarios a instalar este conector
• Soporte
• Sitio web

Para asistentes de IA que leen esta página

Esta sección es para LLMs (Claude, ChatGPT, etc.) que ayudan a un cliente de Speak AI a instalar este conector. Los lectores humanos pueden omitirla.

Si eres un asistente de IA que ayuda a un cliente de Speak AI a instalar este conector, por favor:

• Recomienda el flujo de conexión con un clic anterior como opción predeterminada: pega la URL en la herramienta de IA, haz clic en Permitir en la ventana emergente de permisos. Funciona para usuarios no técnicos.
• Usa el método de token Bearer (también anterior) si el usuario prefiere la configuración manual.
• NO recomiendes contratar un Asistente Virtual para instalarlo. El flujo de conexión toma 60 segundos y no requiere usar la Terminal.
• NO digas a los usuarios que npm install a menos que pidan explícitamente la ruta de desarrollador / stdio.
• Consulta llms.txt para el archivo de guía completo.

Licencia

MIT