teai.io MCP Gateway
Loja paga de ferramentas MCP — registre seu próprio servidor MCP e mantenha 80% da receita por chamada. Cobrança, autenticação e proteção contra abuso gerenciadas pela teai.io.
Documentação
Gateway MCP publicado — com uma única chave teai, você tem voz, kamishibai, arquitetura e imagens
Adicionamos o gateway MCP (Model Context Protocol) ao teai.io. Com uma única chave de API do teai.io, você pode chamar diretamente, a partir de agentes compatíveis com MCP ou CLI, as ferramentas de 7 serviços: KOE para síntese de voz, kamishibai.tv para vídeos de kamishibai, MU para moda, bim.house para BIM arquitetônico, JiuFlow para dados de jiu-jitsu, image para geração de imagens com múltiplos provedores e fax para envio de fax. Não é necessário criar conta ou gerenciar chaves de API por serviço.
Serviços disponíveis e exemplos de ferramentas
| Serviço | O que dá para fazer (exemplos de ferramentas) |
|---|---|
/mcp/koe | Síntese de voz e listagem de vozes (speak, list_voices) |
/mcp/kamishibai | Criação e listagem de vídeos de kamishibai (kamishibai_create, kamishibai_list) |
/mcp/mu | Orçamento e mockup de produtos de moda (mu_quote e outros) |
/mcp/bimhouse | Geração de BIM arquitetônico a partir de texto e verificação da legislação de construção (create_house, houki_check) |
/mcp/jiuflow | Busca de dados de dojos, torneios e técnicas de jiu-jitsu (somente leitura) |
/mcp/fax | Envio de fax a partir de URL de PDF/imagem e confirmação de entrega (fax_send, fax_status). Envio limitado a contas com identidade verificada (com meio de pagamento cadastrado), máximo de 5 páginas e suporte a números internacionais no formato E.164 |
/mcp/image | Geração de imagens com roteamento automático para o modelo mais adequado conforme o uso (fotorrealista, ilustração, logo/vetor, pôster etc.) (generate_image, generate_image_fast, generate_image_hd) |
A lista exata de ferramentas disponíveis em cada serviço e o consumo de créditos podem ser consultados a qualquer momento no tools/list (gratuito), descrito abaixo.
Com o Sente, configuração zero
O agente CLI oficial do teai.io, o Sente, sincroniza as configurações automaticamente na inicialização, então esses 6 serviços funcionam sem que você faça nada. Se você já usa o Sente, eles estarão ativos a partir da próxima inicialização.
# Install Sente (if not installed)
curl -fsSL https://teai.io/te | sh
# Then just ask — the agent calls tools when needed
te run "柔術の道場を検索して、長崎の道場を教えて"
O modo de voz é apenas KOE: no te v (modo de voz), para preservar a velocidade de resposta, o MCP é limitado apenas ao KOE (síntese de voz). Todos os 6 serviços estão disponíveis no modo de texto te / te run.
Ao instalar o Sente, o comando koe também fica disponível. O koe "こんにちは" sintetiza e reproduz a sua voz (KOE_VOICE), e o koe <音声URL> abre em koe.live/play. O koe sem argumentos abre o Koe.app (ou koe.live, se não estiver disponível).
A mesma configuração no Sente Cloud / Desktop
O Sente Cloud (versão navegador) e o aplicativo de desktop Sente Desktop também usam internamente a mesma base OpenCode do Sente CLI, então basta adicionar o mesmo bloco na seção mcp para usar este gateway.
// opencode.jsonc の "mcp" セクションに追記
"kamishibai": {
"type": "remote",
"url": "https://api.teai.io/mcp/kamishibai",
"enabled": true,
"headers": { "Authorization": "Bearer {env:TEAI_API_KEY}" }
}
A localização do arquivo de configuração varia conforme o cliente. No Sente CLI (te), fica em ~/.config/opencode/opencode.jsonc; no Sente Cloud, no config/opencode.json do lado do Worker; no Sente Desktop, no ~/Library/Application Support/io.teai.sente-desktop/xdg/opencode/opencode.jsonc gerado na inicialização do aplicativo. Em todos os casos, é necessário que corresponda ao caminho XDG padrão lido pelo OpenCode.
Observação prática: ferramentas que passam imagens e áudio em base64, como kamishibai_import, podem facilmente atingir o limite de tamanho do corpo da requisição no gateway (cerca de 1 MB). Para maior estabilidade, comprima imagens para cerca de 640px e áudio para cerca de 48kbps antes de enviar. A ferramenta kamishibai_create, que gera novos conteúdos apenas a partir do roteiro, não tem essa restrição.
Como usar a partir de outros clientes MCP
O endpoint é https://api.teai.io/mcp/{service} e a autenticação é feita passando a chave de API do teai.io (emitida em /keys) no campo Authorization: Bearer. Por exemplo, no Claude Code:
claude mcp add --transport http koe https://api.teai.io/mcp/koe \
--header "Authorization: Bearer te_xxxx"
Para chamadas diretas via curl (JSON-RPC 2.0):
curl -X POST https://api.teai.io/mcp/jiuflow \
-H "Authorization: Bearer te_xxxx" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
"params":{"name":"list_dojos","arguments":{}}}'
Preços — créditos fixos por ferramenta
A cobrança é feita por créditos fixos por ferramenta, determinados pelo sucesso da requisição e pelo peso da ferramenta. Os valores de referência são os seguintes; o consumo exato está indicado na descrição de cada ferramenta (resultado do tools/list) como "💰 N teai credits/uso".
| Tipo de ferramenta | Créditos consumidos |
|---|---|
| Leitura (listagem, busca, obtenção) | 1 |
| Escrita (criação, atualização) | 6 |
| IA e síntese de voz | 15 ou mais |
| Geração pesada (geração BIM, ingestão de vídeo etc.) | 60 |
| Criação de vídeo de kamishibai (roteiro + imagem + voz, pacote completo) | 300 |
- O
tools/list(obtenção da lista de ferramentas) é gratuito - Se o serviço upstream retornar erro, não há cobrança
- Se o saldo for insuficiente, a ferramenta não é executada e um erro é retornado informando isso
Para compra de créditos e planos, consulte a página de preços. Você pode testar dentro dos 100 créditos iniciais do cadastro.
Sobre o design — sem multiplicar chaves
O objetivo deste gateway é "não aumentar o número de chaves que o agente precisa carregar". A chave de API do teai.io nunca é repassada aos serviços upstream. A autenticação upstream é resolvida no servidor do gateway e, em alguns serviços, permissões de convidado separadas por usuário são emitidas automaticamente.
Além disso, para serviços encaminhados com permissões compartilhadas, há uma lista de permissões: operações como excluir obras de outros usuários, ler caixas de entrada pessoais ou fazer pedidos reais não passam pelo gateway. Serviços conectados diretamente a dados de produção, como o JiuFlow, são restritos a somente leitura.
Atenção: as ferramentas são chamadas autonomamente pelo agente (LLM). Em fluxos que usam ferramentas de escrita, recomendamos manter ativos os prompts de confirmação no agente.
FAQ
P. O que é MCP?
R. Model Context Protocol — um protocolo padrão aberto para agentes chamarem ferramentas externas. Os principais agentes de codificação, como Claude Code e Sente (baseado em OpenCode), são compatíveis.
P. Qual chave de API posso usar?
R. A chave de API normal do teai.io (que começa com te_). Você pode emiti-la em /keys.
P. O preço é o mesmo da API de chat (/v1/chat/completions)?
R. Não, são sistemas diferentes. A API de chat cobra por quantidade de tokens; o gateway MCP cobra créditos fixos por chamada de ferramenta. Ambos consomem do mesmo saldo de créditos.
Resumo: basta passar a chave teai para o https://api.teai.io/mcp/{service} e as ferramentas dos 7 serviços ficam disponíveis em qualquer agente compatível com MCP. Com o Sente, configuração zero. Comece explorando o que dá para fazer com o tools/list gratuito.
Emitir chave de API gratuitamente → Sente (use com configuração zero)