Documentação Universally

Guias passo a passo, dicas de SEO multilíngue e melhores práticas para ajudar você a traduzir e escalar seu site WordPress.

Conecte-se Universally ao Claude, ChatGPT e outros assistentes de IA

Adicione https://mcp.universally.com/platform ao seu assistente de IA como um conector, faça login no Universally e escolha um espaço de trabalho. O assistente poderá então responder a perguntas sobre seus sites e, se você permitir, alterar traduções, idiomas e regras de glossário para você. Funciona com qualquer assistente que suporte servidores MCP remotos, incluindo Claude, ChatGPT, Cursor e VS Code.

O que é

Universally executa um servidor MCP, a maneira padrão pela qual os assistentes de IA se conectam a serviços externos. O URL do servidor é:

https://mcp.universally.com/platform

Cada conexão está vinculada a um espaço de trabalho. Para trabalhar com um segundo espaço de trabalho, adicione uma segunda conexão.

Antes de começar

  • Uma conta Universally que seja membro do espaço de trabalho que você deseja conectar.
  • Se o espaço de trabalho exigir autenticação de dois fatores, você precisará configurá-la em sua conta, pois o login usa seu login normal do painel.

Entrar

Na primeira vez que o assistente usar o Universally, ele abrirá uma página do Universally em seu navegador:

  1. Faça login no painel se ainda não estiver conectado.
  2. Escolha o espaço de trabalho que esta conexão deve usar. Sua função em cada espaço de trabalho é mostrada ao lado do nome.
  3. Deixe Permitir alterações desmarcado para uma conexão somente leitura, ou marque-o para que o assistente também possa fazer alterações.
  4. Clique em Permitir.

Negar fecha a página sem conectar.

Adicione o conector ao seu assistente

Claude (claude.ai e Claude Desktop)

  1. Abra Configurações e depois Conectores.
  2. Escolha Adicionar conector personalizado.
  3. Cole https://mcp.universally.com/platform como URL e salve.
  4. Clique em Conectar e faça login conforme descrito acima.

Claude Code

Execute:

claude mcp add --transport http universally https://mcp.universally.com/platform

Em seguida, execute /mcp no Claude Code, escolha universally e selecione Autenticar.

ChatGPT

O ChatGPT aceita conectores personalizados no modo de desenvolvedor.

  1. Ative o modo de desenvolvedor nas configurações do ChatGPT.
  2. Crie um conector com https://mcp.universally.com/platform como sua URL e OAuth como sua autenticação.
  3. Faça login conforme descrito acima.

Cursor

Adicione isso a .cursor/mcp.json em seu projeto, ou às configurações globais do Cursor MCP:

{
  "mcpServers": {
    "universally": { "url": "https://mcp.universally.com/platform" }
  }
}

VS Code

Adicione isto a .vscode/mcp.json. O VS Code usa servers onde o Cursor usa mcpServers:

{
  "servers": {
    "universally": { "url": "https://mcp.universally.com/platform" }
  }
}

Outros assistentes

Qualquer assistente que suporte servidores MCP remotos via HTTP com login OAuth pode se conectar com a mesma URL.

O que o assistente pode fazer

Estas são as ferramentas que o assistente recebe:

Área O que o assistente pode fazer
Espaço de trabalho Ler o nome e as configurações do espaço de trabalho. Ler o plano, seus limites e quanto de cada um é usado.
Sites Listar sites, ler um site, criar um site e ler as etapas de instalação de um site.
Idiomas Listar os idiomas de um site, adicionar um idioma e ativar ou desativar um idioma.
Traduções Pesquisar strings, ler uma string com todas as suas traduções, editar uma tradução, aprovar ou reprovar uma tradução e traduzir uma string automaticamente.
Glossário Listar regras de glossário e criar ou editar uma regra.
Análise Ler as solicitações de um site, a atividade de tradução e os URLs mais solicitados nas últimas 24 horas.

Algumas coisas que você precisa saber sobre o que as alterações fazem:

  • A tradução automática de uma string substitui sua tradução atual, incluindo uma escrita por uma pessoa, e as palavras traduzidas contam para o limite de palavras pré-pago do seu plano.
  • Editar uma tradução disponibiliza o novo texto assim que as páginas em cache são atualizadas.
  • Desativar um idioma impede que ele seja exibido para os visitantes. Suas traduções são mantidas e ativá-lo novamente o restaura.
  • Criar um site conta para o limite de sites do seu plano. O site só é traduzido após a instalação, e o assistente fornece as etapas de instalação para a sua plataforma.

O que o assistente não pode fazer

  • Excluir qualquer coisa. Não há ferramenta para excluir um site, idioma, tradução ou regra de glossário. Faça isso no painel.
  • Ir além da sua função. O assistente age como você, e cada chamada é verificada em relação à sua função atual no espaço de trabalho. Um membro só pode ler. Um editor pode editar traduções, adicionar e alternar idiomas, e criar e editar regras de glossário, mas não pode aprovar traduções ou criar sites. Proprietários e administradores podem usar todas as ferramentas. Veja Funções e permissões.
  • Fazer alterações em uma conexão somente leitura. Sem Permitir alterações, todas as ferramentas que alteram algo são recusadas, independentemente da sua função.
  • Ver chaves secretas. Chaves de API privadas nunca chegam ao assistente. Quando uma configuração do WordPress ou Astro precisa de uma, o assistente o direciona para a página do painel que a exibe.
  • Acessar outros espaços de trabalho. Uma conexão só vê o espaço de trabalho que você escolheu ao fazer login.

Conectar com uma chave de API em vez disso

Ferramentas que não suportam login OAuth e scripts podem enviar uma chave de API do espaço de trabalho em vez disso. Crie uma chave na guia Chaves de API do espaço de trabalho com as permissões para as ferramentas que você planeja usar (veja Encontre sua chave de API) e, em seguida, envie-a no cabeçalho X-API-Key.

Para Claude Code:

claude mcp add --transport http universally https://mcp.universally.com/platform --header "X-API-Key: pak_..."

Para Cursor:

{
  "mcpServers": {
    "universally": {
      "url": "https://mcp.universally.com/platform",
      "headers": { "X-API-Key": "pak_..." }
    }
  }
}

As permissões da chave decidem quais ferramentas funcionam. Qualquer pessoa com a chave tem esse acesso, portanto, trate-a como uma senha.

Desconectar

  • Conexão OAuth. Remova o conector Universally no seu assistente. A conexão também termina sozinha se você sair do espaço de trabalho ou sua conta for desativada, e após 30 dias sem uso.
  • Chave de API. Exclua ou regenere a chave na aba Chaves de API do espaço de trabalho. Todo assistente que a utiliza para de funcionar imediatamente.

Se não funcionar

  • O assistente diz que não está mais conectado. Reconecte o Universally no assistente e conecte-se novamente.
  • Uma alteração é recusada. Ou a conexão foi feita sem Permitir alterações, ou sua função não permite. Reconecte com Permitir alterações marcado, ou peça a um proprietário ou administrador.
  • A página de login diz que não há espaço de trabalho para conectar. Sua conta ainda não é membro de nenhum espaço de trabalho. Aceite um convite ou crie um espaço de trabalho no painel primeiro.
Isso foi útil?