Tovanix
Tovanix

Acesso MCP

Conecte sua conta Tovanix a qualquer cliente de IA compatível com MCP. O endpoint é https://tovanix.com/api/mcp/rpc — Streamable HTTP sem estado que aceita apenas POST.

  • Autenticação: Authorization: Bearer <credential> ou cabeçalho X-MCP-Key; as credenciais começam com mcp_live_ e aparecem uma vez
  • Permissões: cada recurso fica desativado até você ativá-lo; tools/list retorna apenas os ativados, com nomes formados por tovanix_ e o nome do recurso
  • Ferramentas de gastos e ações irreversíveis exigem um código de uso único totp_code e respeitam limites por chamada e por dia
  • Listas de IPs de origem permitidos, datas de vencimento e limite padrão de 120 chamadas por minuto (até 600)
  • Três recursos (catálogo de recursos, visão geral da conta e guia da plataforma) e três prompts (revisão da conta, relatório de gastos e verificação de vencimentos)
  • Erros: 401 credencial inválida, 403 origem ou estado da conta não permitido, 405 método diferente de POST, 413 solicitação muito grande
  • Criar uma credencial exige ler e aceitar o Acordo de Acesso MCP; conteúdos e ações enviados em seu nome são sua responsabilidade
  • Além de gastos e ações irreversíveis, configurações importantes como URLs de callback, publicações públicas e acesso público a buckets também exigem código de uso único; publicações, mensagens de suporte, e-mails e leituras ao vivo do Telegram por IA têm limites por conta, publicações e mensagens de suporte repetidas são rejeitadas, e as mensagens de suporte recebem a identificação “Enviado por assistente de IA”

POST /api/mcp/rpc

Três credenciais, cada uma com sua função

MCP (Model Context Protocol) permite que clientes de IA, como Claude, chamem os recursos da sua conta Tovanix como “ferramentas”. No console, você cria uma credencial MCP para cada cliente e ativa individualmente os recursos que ele pode usar; o cliente conecta-se ao endpoint com essa credencial e pode consultar dados e realizar tarefas em uma conversa.

MCP tem endpoint e credenciais próprios, independentes da API aberta e do acesso ao console: excluir uma credencial MCP nunca afeta suas integrações existentes com a API aberta, e vice-versa.

  • API aberta /api/v1/* — Chave de API (X-API-Key / assinatura) — Programas criados por você — As configuradas na chave
  • MCP /api/mcp/rpc — Credencial MCP (Bearer) — Clientes de IA — Nenhuma — ativadas individualmente
  • Console — Sessão de acesso — Você — Tudo na sua conta

Início rápido

Qualquer cliente MCP compatível com Streamable HTTP e que permita definir cabeçalhos de requisição pode conectar. Escolha sua ferramenta abaixo e copie o comando ou a configuração correspondente.

Você também pode verificar a credencial chamando tools/list com curl: o servidor não mantém estado, portanto não é necessário chamar initialize antes.

Só é armazenado um hash da credencial, portanto ela não pode ser recuperada — se a perder, exclua e crie outra. Mantenha-a na configuração do cliente; nunca a coloque em repositório público, captura de tela ou conversa.

Endpoint e autenticação

A página “Acesso MCP” do console mostra o endpoint da sua conta, pronto para copiar.

  • Endpoint — Todas as requisições usam esta única URL.
  • Transporte — Streamable HTTP, sem estado: cada requisição é autenticada individualmente, apenas POST é aceito e nenhum Mcp-Session-Id é emitido; GET e DELETE retornam 405.
  • Autenticação — Authorization: Bearer <credencial>. Se o cliente só permite adicionar cabeçalhos personalizados, sem alterar Authorization, use X-MCP-Key: <credencial>.
  • Versões do protocolo — 2025-06-18 (mais recente), 2025-03-26 e 2024-11-05, negociadas a partir da versão enviada pelo cliente em initialize; versões não suportadas usam a mais recente.
  • Mensagens — JSON-RPC 2.0, com limite de 1 MB por corpo de requisição. Requisições em lote de clientes antigos podem conter no máximo 32 itens.
  • Requisições do navegador — Requisições com cabeçalho Origin de sites diferentes dos próprios sites da plataforma são rejeitadas (proteção contra DNS rebinding). Clientes desktop e de linha de comando não enviam Origin e não são afetados.

Credenciais e permissões

Credenciais começam com mcp_live_ e têm 73 caracteres. Cada uma tem as configurações abaixo, alteráveis no console a qualquer momento; uma credencial expirada ou desativada para de funcionar imediatamente.

Antes de criar uma credencial, você deve ler e aceitar o Acordo de acesso MCP. Ele explica os riscos de permitir que uma IA opere sua conta e quem os assume: operações e perdas ocorridas pelo MCP são de sua responsabilidade. Não é possível criar credenciais sem um acordo publicado; após uma atualização, novas credenciais exigem novo aceite e as existentes continuam funcionando.

Enquanto uma conta estiver restrita, MCP só permite recursos de leitura; escrita, gastos e ações irreversíveis são recusados com uma mensagem direcionando o usuário ao console. Se a conta estiver congelada, todas as requisições retornam 403.

Ferramentas e nomes

Nome da ferramenta = tovanix_ + nome do recurso, com pontos substituídos por sublinhados. Por exemplo, o recurso account.balance.get vira a ferramenta tovanix_account_balance_get.

tools/list retorna apenas os recursos ativados para esta credencial. A descrição de cada ferramenta explica quando usá-la, o significado dos parâmetros e os cuidados necessários; é assim que os clientes de IA escolhem entre ferramentas.

Leitura: somente consulta. Escrita: alterações reversíveis, como editar uma observação. Gasto: retira dinheiro do saldo. Irreversível: não pode ser desfeito, como excluir uma chave ou cancelar um cartão. Ferramentas de gasto e irreversíveis exigem código de uso único (veja a próxima seção). Algumas alterações reversíveis que ainda precisam de aprovação na hora — mudar uma URL de callback, publicar uma postagem, tornar um bucket público — também exigem código de uso único; no console, são marcadas “Código obrigatório”.

Códigos de uso único

Ferramentas de gasto e irreversíveis recebem um parâmetro adicional totp_code, que deve ser o código atual de 6 dígitos do aplicativo autenticador. A IA não pode obter esse código e pedirá a você quando necessário. O mesmo vale para ferramentas marcadas “Código obrigatório”.

  • Cada código funciona uma única vez. Um código usado no console também não pode ser reutilizado pelo MCP.
  • Se a autenticação de dois fatores não estiver ativada na conta, essas ferramentas sempre serão recusadas, com orientação para ativá-la no console.
  • O código é verificado antes de qualquer outra coisa, portanto um código incorreto nunca consome a franquia diária de gastos.

Limites de gastos

Toda chamada com gastos passa por estas quatro etapas, nesta ordem; se alguma falhar, nenhum dinheiro é retirado.

confirmed_total_usd

A maioria das ferramentas de gasto exige confirmed_total_usd: o total informado pela IA e aceito por você. Se o preço real na execução for maior, nada é executado e a IA informa o novo preço.

O que acontece com a franquia em caso de falha

Se uma chamada falhar e houver certeza de que nada foi cobrado, a franquia reservada é devolvida. Se não for possível confirmar o resultado da cobrança, a franquia permanece reservada para que uma cobrança possivelmente realizada nunca seja excluída da contagem. Suas faturas mostram o que realmente foi cobrado.

Limites de chamadas e conteúdo enviado por você

Além do limite de cada credencial, ferramentas que escrevem conteúdo por você ou fazem requisições ao vivo ao Telegram têm limites por conta: compartilhados entre todas as credenciais e reiniciados diariamente às 00:00 UTC+8. Chamadas acima do limite são recusadas e a IA é instruída a parar; postagens na comunidade e mensagens ao suporte com conteúdo exatamente repetido em 10 minutos também são recusadas, enquanto e-mails são deduplicados pela chave de idempotência, não pelo conteúdo. No console, essas ferramentas são marcadas “Com limite de chamadas”.

Conteúdo enviado em seu nome

Ao ativar as ferramentas correspondentes, a IA poderá publicar e responder na comunidade, enviar mensagens ao suporte ao vivo e enviar e-mails pela sua conta SMTP em seu nome. Esse conteúdo representa você, e você é responsável por ele:

Recursos e prompts

Além das ferramentas, o servidor fornece três recursos somente de leitura e três prompts que os clientes podem usar diretamente.

  • tovanix://catalog — Catálogo de recursos: todas as áreas e capacidades e quais estão ativadas nesta credencial. A IA consulta ao receber “não autorizado” ou quando perguntada sobre o que pode fazer.
  • tovanix://account/overview — Visão geral da conta: status, serviços em uso e permissões e consumo da franquia diária desta credencial. O saldo só aparece se “Ver saldo da conta” estiver ativado.
  • tovanix://guide — Guia da plataforma: como valores e moedas são expressos, estados de pedidos e o que confirmar antes de comprar.
  • account_health — — — Verificação da conta: saldo, assinaturas e validade dos serviços, pedidos incomuns e lista de assuntos pendentes.
  • spend_report — days, padrão 30 — Relatório de gastos: faturas recentes e gastos somados por serviço.
  • renewal_check — within_days, padrão 14 — Verificação de expiração: serviços próximos do vencimento e custo de renovação — nada é renovado automaticamente.

Erros e diagnóstico

Problemas de conexão e autenticação retornam códigos de status HTTP. Falhas de negócio retornam resultados de ferramenta (isError: true), cujo texto informa à IA o próximo passo, por exemplo “peça ao usuário um código de uso único” ou “saldo insuficiente — peça ao usuário para recarregar primeiro”.

Conecte o Tovanix MCP a partir de cada ferramenta de IA

Substitua <YOUR_MCP_CREDENTIAL> pela credencial MCP que você criou no console.

  • Claude Code — Executar em um terminal
    claude mcp add --scope user --transport http tovanix https://tovanix.com/api/mcp/rpc --header "Authorization: Bearer <YOUR_MCP_CREDENTIAL>"
  • Codex — Arquivo de configuração: ~/.codex/config.toml
    [mcp_servers.tovanix]
    url = "https://tovanix.com/api/mcp/rpc"
    bearer_token_env_var = "TOVANIX_MCP_CREDENTIAL"
  • Cursor — Arquivo de configuração: ~/.cursor/mcp.json
    {
      "mcpServers": {
        "tovanix": {
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • GitHub Copilot (VS Code) — Arquivo de configuração: .vscode/mcp.json
    {
      "servers": {
        "tovanix": {
          "type": "http",
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer ${input:tovanix-credential}"
          }
        }
      },
      "inputs": [
        {
          "type": "promptString",
          "id": "tovanix-credential",
          "description": "Tovanix MCP credential",
          "password": true
        }
      ]
    }
  • Gemini CLI — Arquivo de configuração: ~/.gemini/settings.json
    {
      "mcpServers": {
        "tovanix": {
          "httpUrl": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • OpenCode — Arquivo de configuração: ~/.config/opencode/opencode.json
    {
      "$schema": "https://opencode.ai/config.json",
      "mcp": {
        "tovanix": {
          "type": "remote",
          "url": "https://tovanix.com/api/mcp/rpc",
          "enabled": true,
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Qwen Code — Executar em um terminal
    qwen mcp add --scope user --transport http tovanix https://tovanix.com/api/mcp/rpc --header "Authorization: Bearer <YOUR_MCP_CREDENTIAL>"
  • Kimi Code CLI — Arquivo de configuração: ~/.kimi-code/mcp.json
    {
      "mcpServers": {
        "tovanix": {
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • CodeBuddy Code — Executar em um terminal
    codebuddy mcp add --scope user --transport http --header "Authorization: Bearer <YOUR_MCP_CREDENTIAL>" tovanix https://tovanix.com/api/mcp/rpc
  • Qoder CLI — Arquivo de configuração: ~/.qoder/settings.json
    {
      "mcpServers": {
        "tovanix": {
          "type": "streamable-http",
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Kiro — Arquivo de configuração: ~/.kiro/settings/mcp.json
    {
      "mcpServers": {
        "tovanix": {
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Trae — Arquivo de configuração: .trae/mcp.json
    {
      "mcpServers": {
        "tovanix": {
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Trae CN — Arquivo de configuração: .trae/mcp.json
    {
      "mcpServers": {
        "tovanix": {
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Trae CLI — Arquivo de configuração: trae_cli.yaml
    mcp_servers:
      - name: "tovanix"
        url: "https://tovanix.com/api/mcp/rpc"
        type: "http"
        headers:
          Authorization: "Bearer <YOUR_MCP_CREDENTIAL>"
  • GitHub Copilot CLI — Arquivo de configuração: ~/.copilot/mcp-config.json
    {
      "mcpServers": {
        "tovanix": {
          "type": "http",
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          },
          "tools": [
            "*"
          ]
        }
      }
    }
  • Cline — Arquivo de configuração: cline_mcp_settings.json
    {
      "mcpServers": {
        "tovanix": {
          "type": "streamableHttp",
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Kilo Code — Arquivo de configuração: ~/.config/kilo/kilo.jsonc
    {
      "mcp": {
        "tovanix": {
          "type": "remote",
          "url": "https://tovanix.com/api/mcp/rpc",
          "enabled": true,
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Continue — Arquivo de configuração: ~/.continue/config.yaml
    mcpServers:
      - name: tovanix
        type: streamable-http
        url: https://tovanix.com/api/mcp/rpc
        requestOptions:
          headers:
            Authorization: Bearer <YOUR_MCP_CREDENTIAL>
  • Zed — Arquivo de configuração: ~/.config/zed/settings.json
    {
      "context_servers": {
        "tovanix": {
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Junie — Arquivo de configuração: ~/.junie/mcp/mcp.json
    {
      "mcpServers": {
        "tovanix": {
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Amp — Arquivo de configuração: ~/.config/amp/settings.json
    {
      "amp.mcpServers": {
        "tovanix": {
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Goose — Arquivo de configuração: ~/.config/goose/config.yaml
    extensions:
      tovanix:
        enabled: true
        type: streamable_http
        name: tovanix
        uri: https://tovanix.com/api/mcp/rpc
        headers:
          Authorization: "Bearer <YOUR_MCP_CREDENTIAL>"
        timeout: 300
  • Augment (Auggie) — Executar em um terminal
    auggie mcp add tovanix --transport http --url https://tovanix.com/api/mcp/rpc --header "Authorization:Bearer <YOUR_MCP_CREDENTIAL>"
  • Factory Droid — Executar em um terminal
    droid mcp add tovanix https://tovanix.com/api/mcp/rpc --type http --header "Authorization: Bearer <YOUR_MCP_CREDENTIAL>" --no-oauth
  • Crush — Arquivo de configuração: ~/.config/crush/crushrc
    mcp add tovanix --type http --url https://tovanix.com/api/mcp/rpc --header Authorization "Bearer <YOUR_MCP_CREDENTIAL>"
  • Warp — Colar nas configurações do aplicativo
    {
      "tovanix": {
        "url": "https://tovanix.com/api/mcp/rpc",
        "headers": {
          "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
        }
      }
    }
  • Windsurf — Arquivo de configuração: ~/.codeium/windsurf/mcp_config.json
    {
      "mcpServers": {
        "tovanix": {
          "serverUrl": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Claude (web / aplicativo para computador) — Informe o endereço no aplicativo e adicione o cabeçalho Authorization (Bearer + credencial)
    https://tovanix.com/api/mcp/rpc
  • LM Studio — Arquivo de configuração: mcp.json
    {
      "mcpServers": {
        "tovanix": {
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Dify — Informe o endereço no aplicativo e adicione o cabeçalho Authorization (Bearer + credencial)
    https://tovanix.com/api/mcp/rpc
  • Coze — Informe o endereço no aplicativo e adicione o cabeçalho Authorization (Bearer + credencial)
    https://tovanix.com/api/mcp/rpc
  • n8n — Informe o endereço no aplicativo e adicione o cabeçalho Authorization (Bearer + credencial)
    https://tovanix.com/api/mcp/rpc
  • Outros clientes MCP — Colar nas configurações do aplicativo
    {
      "mcpServers": {
        "tovanix": {
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }

Perguntas frequentes

Por que tools/list retorna uma lista vazia?

A credencial ainda não tem recursos ativados. Ative os necessários em “Acesso MCP” no console e reconecte.

Por que as ferramentas de gastos são sempre recusadas?

Verifique três itens: se os limites de gastos da credencial ainda estão no padrão 0, se a autenticação de dois fatores está ativada e se a cota diária foi esgotada.

Páginas relacionadas: Deixe seu assistente de IA operar sua conta Tovanix · Documentação da API · Integração para desenvolvedores

Carregando…