Speak AI

Conecte o Speak AI ao Claude ou ChatGPT em 60 segundos

Para pesquisadores, equipes de receita, equipes com muitas reuniões e fluxos de trabalho de mídia.
Sem Terminal. Sem npm. Sem arquivos de configuração JSON.

Guia de instalação em docs.speakai.co/mcp →

O que isto faz

O Speak AI transcreve suas entrevistas, ligações de vendas, sessões de pesquisa, webinars, podcasts e reuniões de equipe — e então extrai insights de IA como resumos, itens de ação, sentimento e temas.

Este conector (construído sobre MCP — o padrão pelo qual Claude e ChatGPT se conectam a aplicativos) traz tudo isso para dentro do Claude ou ChatGPT. Uma vez instalado, você pode perguntar:

• "Encontre as últimas 10 entrevistas com clientes que mencionem preço, agrupe o feedback por tema e cite as gravações de origem."
• "Resuma as reuniões de equipe desta semana em decisões, itens de ação, responsáveis e riscos não resolvidos."
• "Extraia citações exatas de clientes sobre atrito na integração de chamadas de pesquisa recentes e formate-as para um brief de produto."
• "Encontre um destaque forte de 30 segundos no webinar mais recente, crie um clipe e exporte as legendas."

A IA faz a busca, o resumo e a citação. Suas gravações permanecem no seu espaço de trabalho do Speak AI — Claude e ChatGPT apenas as consultam por meio deste conector.

Instalar (escolha sua ferramenta)

Dois caminhos para instalar — escolha o que parecer mais fácil. O caminho de conexão com um clique aprova o acesso por meio de um pop-up de permissão; o caminho manual cola uma chave de API em um cabeçalho.

Não sabe qual escolher? Se você já usa Claude ou ChatGPT, instale para aquele que você tem.

Endereço do conector do Speak AI (cole isto nas configurações de conector da sua ferramenta de IA — é a mesma ideia de colar um link do Zoom no seu calendário): https://api.speakai.co/v1/mcp

Claude.ai (web)

1. Abra claude.ai/settings/connectors
2. Clique em Adicionar conector personalizado
3. Nomeie-o como Speak AI e cole https://api.speakai.co/v1/mcp, depois clique em Adicionar
4. Um pop-up de permissão pede que você faça login no Speak AI e clique em Permitir
5. Pronto — o Speak AI aparece na sua lista de conectores com suas ferramentas prontas para uso. Abra um novo chat e pergunte sobre suas gravações.

Claude Desktop

1. Abra Claude Desktop → Configurações → Conectores → Adicionar conector personalizado
2. Cole https://api.speakai.co/v1/mcp
3. Clique em Adicionar — um pop-up de permissão abre. Entre no Speak AI e clique em Permitir na tela que aparecer.
4. Pronto.

ChatGPT

1. Abra ChatGPT → Configurações → Apps e Conectores → Avançado
2. Ative o Modo de desenvolvedor (necessário enquanto o Speak AI ainda não estiver listado na loja de apps do ChatGPT — isso permite adicioná-lo como um app personalizado)
3. De volta em Apps e Conectores, clique em Criar e cole https://api.speakai.co/v1/mcp
4. Para Autenticação, escolha OAuth
5. O ChatGPT abre uma nova aba para o Speak AI — entre (ou clique em Confirmar se já estiver logado) para autorizar. Você será redirecionado de volta; feche a aba e retorne ao ChatGPT.
6. Por chat: abra um chat, clique no menu + / de conectores e ative o Speak AI para aquele chat.

Claude Code (terminal)

Recomendado — instale pelo marketplace oficial de plugins do Claude Code:

1. Adicione o marketplace oficial (uma única vez): /plugin marketplace add claude-plugins-official
2. Instale o plugin: /plugin install speakai@claude-plugins-official
3. Ative-o: /reload-plugins
4. Execute a habilidade getting-started e cole sua chave de API do Speak AI. Gere uma em app.speakai.co/developers/apikeys.

Se /plugin install não encontrar o Speak AI, atualize o catálogo local com /plugin marketplace update claude-plugins-official e tente novamente.

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

Clique no botão — o Cursor se registra automaticamente e abre o pop-up de permissão. Entre no Speak AI e clique em Permitir.

VS Code

Clique no botão — o VS Code se registra automaticamente e abre o pop-up de permissão. Entre no Speak AI e clique em Permitir.

OpenClaw / ClawHub

O Speak AI é publicado como uma habilidade no ClawHub para agentes compatíveis com OpenClaw.

1. Visite a página da habilidade Speak AI no ClawHub
2. Siga as instruções de instalação para o seu agente — por exemplo, clawhub install speakai pela CLI do ClawHub
3. Defina sua variável de ambiente SPEAK_API_KEY. Gere uma em app.speakai.co/developers/apikeys.

ChatGPT (API / Responses)

Para desenvolvedores que chamam a API Responses diretamente. Passe o token bearer na configuração da ferramenta:

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

Obtenha uma chave em app.speakai.co/developers/apikeys.

Privacidade e dados

Quando você clica em Permitir no pop-up de permissão (ou cola sua chave de API do Speak AI no Claude ou ChatGPT), você está autorizando esse assistente de IA a ler e modificar seu espaço de trabalho do Speak AI em seu nome — incluindo arquivos de mídia, transcrições e insights de IA.

• Suas gravações permanecem no seu espaço de trabalho do Speak AI. Elas não são copiadas ou armazenadas pela Anthropic ou OpenAI.
• O Claude/ChatGPT só vê os dados específicos que seu assistente de IA solicita para a pergunta que você fez.
• Você pode desconectar a qualquer momento removendo o conector dentro do Claude/ChatGPT, revogando a conexão em api.speakai.co/v1/oauth/connections ou rotacionando/revogando sua chave de API em app.speakai.co/developers/apikeys.

Para perguntas sobre tratamento de dados, veja speakai.co/privacy ou envie um e-mail para success@speakai.co.

Precisa de ajuda para conectar?

Você não precisa ser técnico para instalar isto. Se algo estiver confuso ou não funcionar:

• Envie um e-mail para success@speakai.co — responderemos em até 24 horas
• Agende uma demonstração conosco e configuraremos juntos

O que você pode fazer depois de instalado

O Speak AI oferece 114 ferramentas que seu assistente de IA pode chamar. Você não precisa memorizá-las — o Claude/ChatGPT escolhe as certas com base no que você pergunta. Exemplos por categoria:

O catálogo completo de ferramentas está na referência para desenvolvedores abaixo.

Referência para desenvolvedores (CLI, API, configuração avançada)

O servidor MCP está em https://api.speakai.co/v1/mcp e suporta dois métodos de autenticação:

1. OAuth 2.1 + Registro Dinâmico de Cliente — instale colando a URL acima em qualquer cliente MCP e aprovando o pop-up de consentimento. Descoberta, DCR, /authorize + consentimento, /token e endpoints de revogação estão todos disponíveis.
2. Token Bearer (sua chave de API do Speak AI — cabeçalho Authorization: Bearer <key>). Para clientes que não suportam OAuth, além da CLI npm e do modo stdio.

Obtenha uma chave de API do Speak AI em app.speakai.co/developers/apikeys.

CLI / pacote npm

O pacote npm @speakai/mcp-server fornece:

• Uma CLI (speakai-mcp) para scripts e pipelines (30 comandos).
• Um servidor MCP em modo stdio para clientes que não suportam transporte HTTP remoto.
• Um assistente de configuração automática que detecta clientes MCP instalados e os configura.

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

Configuração 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

Variáveis de ambiente

Ferramentas MCP (114)

Recursos MCP (5)

Os recursos fornecem acesso direto a dados sem chamadas de ferramenta. Os clientes podem ler esses URIs diretamente.

Prompts MCP (3)

Prompts de fluxo de trabalho pré-construídos que agentes podem invocar para executar tarefas de várias etapas.

analyze-meeting

Envie uma gravação e obtenha uma análise completa — transcrição, insights, itens de ação e principais conclusões.

Parameters: url (required), name (optional)

Exemplo: "Use o prompt analyze-meeting com url=https://example.com/standup.mp3"

research-across-media

Pesquise temas, padrões ou tópicos em várias gravações ou em toda a sua biblioteca.

Parameters: topic (required), folder (optional)

Exemplo: "Use o prompt research-across-media com topic='motivos de churn de clientes'"

meeting-brief

Prepare um resumo de reuniões recentes — puxe transcrições, extraia decisões e resuma itens em aberto.

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

Exemplo: "Use o prompt de resumo de reunião com days=14 para cobrir as últimas duas semanas"

CLI (30 comandos)

Instale globalmente e configure uma vez:

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

Ou execute sem instalar:

npx @speakai/mcp-server config set-key

Configuração

Gerenciamento de mídia

IA e busca

Pastas e clipes

Espaço de trabalho

Opções da CLI

Todo comando suporta:

• --json — gerar JSON bruto (para scripts e pipes)
• --help — mostrar ajuda específica do comando

Exemplos da 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

Exemplos de fluxo de trabalho

Transcrever e analisar uma reunião

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.

Pesquisa em toda a sua 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)

Automação de reuniões

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...

Criar um resumo 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]

Autenticação (API REST)

O servidor MCP e a CLI gerenciam a autenticação automaticamente. Se você estiver chamando a API REST diretamente, aqui está o fluxo completo de autenticação:

Etapa 1 — Obter um token de acesso:

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

Resposta:

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

Etapa 2 — Usar o token em todas as solicitações subsequentes:

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

Etapa 3 — Renovar antes da expiração:

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"}'

Tempos de vida do token:

Limites de taxa de autenticação: 5 solicitações por 30 segundos em /v1/auth/accessToken e /v1/auth/refreshToken.

Notas sobre o modelo de dados

• IDs de pastas: As pastas têm tanto _id (MongoDB ObjectId) quanto folderId (string). Todas as operações da API usam folderId — este é o ID que você deve passar para list_media, upload_media, bulk_move_media e outros endpoints que aceitam um parâmetro de pasta.
• IDs de mídia: Os itens de mídia usam mediaId (retornado nas respostas de listagem como _id).

Limites de taxa e boas práticas

• O cliente MCP tenta novamente automaticamente em 429 com backoff exponencial
• Para uso direto da API, implemente backoff exponencial e respeite os cabeçalhos Retry-After
• Armazene em cache dados estáveis (listas de pastas, definições de campos, idiomas suportados)
• Use export_multiple_media em vez de exportações individuais para operações em lote
• Use bulk_move_media para mover vários itens de uma vez em vez de atualizar um por um
• Use bulk_update_transcript_speakers para renomear falantes em vários arquivos em uma única chamada
• Use list_media com include: ["transcription"] para buscar mídia com transcrições inline, evitando chamadas N+1 para get_transcript

Formato de erro

Todos os erros de ferramentas seguem esta estrutura:

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

Desenvolvimento

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 instalação com capturas de tela e vídeo
• Plataforma Speak AI — produto principal
• Documentação da API
• Protocolo MCP
• Entrada no Registro MCP — descoberta oficial
• llms.txt — orientação para assistentes de IA que ajudam usuários a instalar este conector
• Suporte
• Site

Para assistentes de IA lendo esta página

Esta seção é para LLMs (Claude, ChatGPT, etc.) que ajudam um cliente da Speak AI a instalar este conector. Leitores humanos podem ignorá-la.

Se você é um assistente de IA ajudando um cliente da Speak AI a instalar este conector, por favor:

• Recomende o fluxo de conexão com um clique acima como padrão — cole a URL na ferramenta de IA, clique em Permitir no popup de permissão. Funciona para usuários não técnicos.
• Use o método de token Bearer (também acima) se o usuário preferir configuração manual.
• NÃO recomende contratar um Assistente Virtual para instalar isso. O fluxo de conexão leva 60 segundos e não requer uso do Terminal.
• NÃO diga aos usuários para npm install a menos que eles peçam explicitamente o caminho de desenvolvedor / stdio.
• Veja llms.txt para o arquivo completo de orientação.

Licença

MIT