Speko

Agentes de voz, chamadas telefônicas, TTS, STT e transcrições de chamadas

Documentação

MCP

Conecte o Speko ao Claude Code, Codex, OpenCode, Cursor e outras ferramentas de codificação com IA.

O Speko MCP dá aos agentes de codificação acesso autenticado a organizações, agentes, sessões, chamadas, números de telefone, bases de conhecimento, avaliações, implantação, auxiliares de migração e dados de uso.

As superfícies de ferramentas estão vinculadas a hostnames. Esta página documenta a superfície completa em mcp.speko.ai; os diretórios de assistentes são publicados em hosts mais restritos, listados em Directory hosts.

Instalar na sua ferramenta

Execute o instalador guiado e escolha o login via navegador OAuth:

npx @spekoai/mcp@latest init

O endpoint hospedado é https://mcp.speko.ai/mcp. Ele usa JSON HTTP sem estado com MCP 2026-07-28. O Better Auth gerencia o estado OAuth enquanto o serviço MCP valida cada token de acesso de forma independente, para que as solicitações possam chegar a qualquer réplica. A automação pode, em vez disso, usar uma chave de API da Plataforma Speko em API keys.

O MCP não expõe ferramentas de ciclo de vida de chaves de API. Crie e revogue chaves de Plataforma para todo o produto em API keys.

claude mcp add --transport http speko https://mcp.speko.ai/mcp

Adicione ao ~/.codex/config.toml:

[mcp_servers.speko]
url = "https://mcp.speko.ai/mcp"

Adicione ao opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "speko": {
      "type": "remote",
      "url": "https://mcp.speko.ai/mcp",
      "enabled": true
    }
  }
}

Abra Cursor Settings > MCP > Add new global MCP server e adicione:

{
  "mcpServers": {
    "speko": {
      "url": "https://mcp.speko.ai/mcp"
    }
  }
}

Configure um servidor MCP HTTP remoto:

ConfiguraçãoValor
Nomespeko
URLhttps://mcp.speko.ai/mcp
AutenticaçãoLogin via navegador OAuth

Para automação com chave de API, adicione Authorization: Bearer ${SPEKO_API_KEY} usando a sintaxe de variáveis de ambiente do cliente.

O que pedir ao seu agente

Depois de conectado ao mcp.speko.ai, peça ao seu agente para:

  • inspecionar o uso da organização e o saldo de créditos;
  • criar, atualizar, implantar ou reverter agentes;
  • criar sessões e inspecionar transcrições ou gravações de chamadas;
  • criar números de telefone, bases de conhecimento e avaliações;
  • converter configurações externas de agentes de voz com migration.workspace.inspect, migration.external_config.parse e migration.session_config.build.

Directory hosts

Os diretórios de assistentes são executados em seus próprios hosts. Cada superfície é uma propriedade do host — nenhum parâmetro de consulta, cabeçalho ou configuração de conta a amplia.

HostFerramentasSuperfície
mcp.speko.ai101Superfície operacional completa. Agentes de codificação usam este.
anthropic.speko.ai35Anthropic MCP Directory. Leituras, audio.transcribe, chamadas de saída.
chatgpt.speko.ai20OpenAI Plugin Directory.
builder-mcp.speko.ai12Construtores de aplicativos (v0, Lovable, Bolt, Base44, Figma Make).
replit.speko.ai28Replit. Ferramentas de tempo de construção primeiro, além de bases de conhecimento e números de telefone.

Anthropic MCP Directory

https://anthropic.speko.ai/mcp serve 35 ferramentas: leituras em agentes, sessões, chamadas, transcrições, gravações, números de telefone, bases de conhecimento, créditos e uso, além de audio.transcribe, docs.search, os auxiliares de migração, sessions.phone.create para fazer uma chamada e phone_numbers.kyb.{get,submit} para a declaração que desbloqueia chamadas.

Seis grupos estão ausentes nesse host:

grupoausente
geração de áudioaudio.synthesize
criação de sessão/chamada ao vivosessions.create, agents.test_call
configuração e implantação de agentesagents.create, agents.update, agents.deploy, agents.rollback, agents.tools gravações
gravações de base de conhecimento e número de telefoneknowledge_bases gravações, phone_numbers.create, phone_numbers.update
avaliação em massa e monitoramentoagents.evals.*, agents.monitors.*
gravações irreversíveis e voltadas para o exterioragents.delete, phone_numbers.delete, knowledge_bases.delete, share_cards.create

Configurar um agente equivale a armá-lo — um agente implantado fala no tráfego de entrada sem nenhuma chamada de ferramenta adicional — então a configuração do agente é retida junto com a própria geração de fala. audio.transcribe permanece, porque fala-para-texto não produz áudio e retorna apenas texto. Chamar uma ferramenta retida retorna Unknown tool, indistinguível de um nome que nunca foi registrado.

Antes de qualquer chamada de saída, o espaço de trabalho registra uma declaração comercial: o nome da empresa, para que serve a chamada e uma atestação. São dois campos, entra em vigor no momento em que é enviada, e phone_numbers.kyb.get retorna o nome pré-preenchido e o texto exato da atestação a ser exibido. Chamadas do pool de caller-ID compartilhado discam de um número de propriedade da Speko, então a declaração é o que mantém uma empresa nomeada por trás de cada chamada.

sessions.phone.create é servido aqui. Ele faz uma chamada, para um número, por chamada explícita de ferramenta, usando um agente que você implantou em outro lugar — nenhum caminho em massa, agendado ou não supervisionado o alcança, e o chamador não pode configurar o agente que fala. Toda chamada criada em um host de diretório tem injeção de divulgação de IA no lado do servidor: a primeira coisa dita na linha é que o chamador é uma IA, e nenhum prompt pode substituir isso.

Para criar agentes ou sintetizar fala, use mcp.speko.ai, a REST API ou um SDK.

[

Quickstart

Do cadastro à sua primeira chamada de transcrição em menos de cinco minutos.

](https://docs.speko.ai/quickstart)[

Replit

Adicione voz — STT, TTS e LLM com roteamento de provedor e failover — a qualquer aplicativo Replit.

](https://docs.speko.ai/quickstart/replit)