Conecte seu assistente de IA (MCP)
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.
| Cliente | Configuração |
|---|---|
| Claude Code | Execute claude mcp add --transport http transept https://app.transept.ai/api/public/v1/mcp em um terminal |
| Claude Desktop | Configurações → Conectores → Adicionar conector personalizado, cole a URL do endpoint |
| Cursor | Adicione um servidor com "url": "https://app.transept.ai/api/public/v1/mcp" ao seu mcp.json |
| Outros | Qualquer 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.
| O que você está conectando | Autenticaçã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 headless | Uma 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.
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.
Ainda com dúvidas? Pergunte à Literess no aplicativo, ou escreva para [email protected].