Navegar na central de ajuda

Conecte seu assistente de IA (MCP)

Mantido por Vitalii VlasiukCo-founder

A Transept possui um endpoint MCP ao qual os assistentes de IA se conectam diretamente. Uma vez conectado, o assistente pode gerenciar todo o ciclo (importar documentos, executar fluxos de trabalho em diversos idiomas, gerenciar glossários e guias de estilo, ler os resultados), enquanto suas permissões e saldo de palavras permanecem sob seu controle.

Nesta página

O que é o endpoint MCP?

O MCP (Model Context Protocol) é o padrão que os assistentes de IA utilizam para acionar ferramentas externas. A Transept disponibiliza um endpoint para isso, https://app.transept.ai/api/public/v1/mcp, e um assistente conectado a ele obtém as mesmas funcionalidades que um script teria via API, organizadas como ferramentas que ele pode acionar de forma autônoma: criar um documento, orçar uma execução, iniciá-la, consultar o status e recuperar as traduções.

A diferença prática em relação a copiar e colar texto em um chatbot é que o assistente trabalha diretamente nos seus documentos reais, aplicando seus glossários, seus guias de estilo e sua memória de tradução. Os resultados ficam na Transept, onde você pode revisá-los e exportá-los como qualquer outro trabalho.

Como conecto o Claude Code, o Claude Desktop ou o Cursor?

A conexão utiliza o padrão OAuth: adicione a URL ao seu cliente e a primeira conexão abrirá uma janela do navegador solicitando que você aprove o acesso. Basta aprovar e o cliente estará vinculado; não é preciso colar nenhuma chave. Snippets prontos para cada cliente estão na página de Integrações do app.

Configuração única por cliente MCP.
ClienteConfiguração
Claude CodeExecute claude mcp add --transport http transept https://app.transept.ai/api/public/v1/mcp em um terminal
Claude DesktopConfigurações → Conectores → Adicionar conector personalizado, cole a URL do endpoint
CursorAdicione um servidor com "url": "https://app.transept.ai/api/public/v1/mcp" ao seu mcp.json
OutrosQualquer cliente MCP que suporte HTTP via streaming: basta apontá-lo para a mesma URL

Preciso de uma chave de API?

Não é para clientes interativos: o OAuth já cuida disso. As chaves são para máquinas que não conseguem abrir um navegador. De qualquer forma, a conexão aparece em Configurações → Desenvolvedor como uma entrada revogável, então basta um clique para desconectar, não importa como ela tenha sido feita.

OAuth ou chave de API, dependendo de como o assistente é executado.
O que você está conectandoAutenticação a ser usada
Um assistente que você opera diretamente (Claude, Cursor)OAuth: consentimento via navegador na primeira conexão; nada para colar
CI, um servidor, um agente headlessUma chave de API de Configurações → Desenvolvedor, enviada como um cabeçalho Authorization: Bearer

O que o assistente realmente pode fazer?

As ferramentas abrangem o ciclo de ponta a ponta, permitindo que uma única conversa leve um documento da importação até as traduções revisadas:

  • Importar conteúdo: documentos via colagem ou um catálogo de strings indexado, com contextos e placeholders.
  • Calcule o custo de qualquer execução gratuitamente, execute em seguida um fluxo de trabalho em todos os idiomas de destino de uma só vez e acompanhe o progresso por idioma.
  • Criar e expandir glossários, ler guias de estilo e consultar a memória de tradução antes de traduzir.
  • Ler os resultados: por bloco para prosa, ou indexados por ID de string para catálogos.
  • Registrar webhooks para que seus sistemas recebam um evento assinado assim que uma execução terminar.
  • O que fica de fora, por design: uploads de arquivos e exportações binárias (DOCX, XLIFF, TMX) residem na API REST, e o gerenciamento de chaves permanece uma ação humana no app; um assistente jamais poderá gerar a própria chave.

Como meus gastos são protegidos?

Três mecanismos de proteção, todos aplicados no lado da Transept em vez de serem confiados ao assistente:

  • Permissões. Cada chamada de ferramenta é verificada em relação ao que você autorizou: os escopos da chave ou do consentimento OAuth. Uma chamada fora desses limites é recusada, informando a permissão ausente.
  • Orçar e confirmar. Qualquer ação que consuma palavras primeiro retorna a estimativa de palavras e para. A execução só começa quando o assistente confirma explicitamente, o que significa que você vê o preço na conversa antes que o gasto ocorra. Etapas de revisão em seus fluxos de trabalho ainda pausam a execução; para continuar, é necessária uma aprovação explícita, vinda de você ou do assistente sob sua instrução.
  • Revogação. A conexão pode ser encerrada por você a qualquer momento: a próxima chamada de um assistente revogado será recusada, esteja ele no meio de uma conversa ou não.

O conteúdo pode entrar e sair sem que eu precise abrir o app?

Sim: combine a conexão com um gatilho de webhook e o ciclo se fecha. Sua plataforma de e-mail, CMS ou um script faz o POST do conteúdo para a URL do gatilho (o corpo da requisição se torna o documento), o fluxo de trabalho o traduz e um webhook ou o assistente lê as traduções finalizadas: saem dez idiomas para cada modelo que entra, sem que ninguém precise abrir o editor.

Este é o padrão por trás da localização de modelos de e-mail e do trabalho contínuo com catálogos de strings: a plataforma envia o que mudou, o Transept retraduz apenas isso e seu pipeline busca os resultados. Sua parte é a revisão — todo o trabalho mecânico é delegado.

Perguntas frequentes

O assistente pode gastar minhas palavras sem me consultar?

Não. Qualquer ferramenta que possa iniciar uma execução cobrada primeiro informa a estimativa de palavras e não faz mais nada; o assistente precisa confirmar explicitamente antes de a execução começar, e a confirmação fica visível no seu chat. Ações gratuitas (importação, estimativa, leitura de resultados) não precisam de confirmação porque nunca geram cobrança.

Como desconectar um assistente?

Em Configurações → Desenvolvedor. Cada conexão (consentimento OAuth ou chave colada) aparece ali como uma entrada revogável. Revogue-a e a próxima chamada do assistente será recusada; não há nada para limpar no lado do assistente.

Quais clientes MCP são compatíveis?

Qualquer cliente que utilize MCP via HTTP com suporte a streaming: Claude Code, Claude Desktop, Cursor e frameworks de agentes mais recentes, todos são compatíveis. Clientes interativos se conectam via OAuth; os headless enviam uma chave de API como um cabeçalho Bearer. O endpoint é a mesma URL em ambos os casos.

Explore os recursos

Ainda com dúvidas? Pergunte à Literess no aplicativo, ou escreva para [email protected].