Developer / MCP

Degrau 7 de 25

Ligue uma ferramenta de codificação de IA a Altified

O MCP permite que ferramentas como o Cursor, o Claude e os agentes do VS Code perguntem Altified sobre este projeto e executem ações aprovadas para si.

MCP significa Protocolo de Contexto do ModeloEm termos simples, é uma ligação segura entre uma ferramenta de codificação de IA e o seu projeto Altified. A ferramenta de IA não se liga diretamente à sua base de dados. Comunica com o servidor Altified MCP, que verifica o seu token e permissões antes de utilizar Altified.

A ligação parece-se com isto:

A sua ferramenta de IA → Altified Servidor MCP → O seu projeto Altified

O que são configurações MCP?

As definições do MCP são o local dentro de um editor de código de IA onde adiciona ferramentas externas para a IA utilizar. Não são uma configuração no painel Altified. Procure no seu editor um menu ou ficheiro chamado MCP, Servidores MCP, Ferramentas, ou Integrações.

O editor deve ser compatível com MCP. Um editor de texto comum, sem assistente de IA, não pode utilizar esta ligação.

Configure tudo do início ao fim.

  1. Abra o seu projeto. No painel Altified, abra o projeto que pretende que a sua ferramenta de codificação de IA utilize e, em seguida, escolha MCP a partir dos cartões do projeto ou da navegação do projeto.
  2. Selecione as permissões. Escolher Deixe a minha IA configurar tudo. se pretende que a IA integre Altified para si, ou Somente leitura Se o programa apenas inspecionar o seu projeto, cada alteração exigirá ainda a sua confirmação.
  3. Criar um token. Dê um nome como... Cursor on my laptopOs tokens criados a partir de um projeto estão limitados a esse projeto.
  4. Copie o token imediatamente. Altified mostra o token completo apenas uma vez. Funciona como uma password para a ferramenta de IA.
  5. Adicione Altified ao seu editor. Após a criação do token, selecione o seu editor no painel de tokens. O Cursor e o VS Code possuem um editor de texto. Instalar botão; o Claude Code disponibiliza um comando para executar; outros editores obtêm o JSON com o seu token já preenchido.
  6. Está a usar outro editor? Pesquise as suas configurações para MCPEm seguida, escolha uma opção como Adicionar servidor, Novo servidor MCP, ou Editar configuraçãoA redação varia de editor para editor.
  7. Cole e guarde a configuração. Se o editor aceitar JSON, cole a configuração que copiou de Altified. Se solicitar campos separados, utilize o URL do servidor, o Authorization cabeçalho e o token apresentado abaixo.
  8. Reinicie ou recarregue o editor. Alguns editores só se ligam a novos servidores MCP depois de o assistente de IA ou o editor serem reiniciados. Aprove ou ative o servidor Altified se o editor o solicitar.
  9. Peça para integrar Altified. Abra a pasta da sua aplicação no editor e pergunte: “Integre Altified neste projeto.” A IA lê as instruções de configuração do seu projeto, mostra um plano, aguarda a sua aprovação, instala o SDK, coloca o seletor de idioma e verifica se o SDK está ligado.

Run in your project's terminal.

claude mcp add --transport http altified https://mcp.altified.com/mcp \
  --header "Authorization: Bearer YOUR_MCP_TOKEN"

Os exemplos acima utilizam YOUR_MCP_TOKEN como um marcador de posição. A página MCP do seu projeto preenche automaticamente o seu token real. Nunca publique a configuração concluída.

Outras coisas a perguntar

  • “Realizar uma verificação de saúde do meu projeto Altified.” — Ligação SDK, chave secreta, seletor, progresso da tradução, utilização e a auditoria SEO mais recente.
  • “Ajude-me a configurar o seletor de idioma Altified.” — reveja os idiomas, a ordem, os rótulos e o estilo e, em seguida, publique após a sua aprovação.
  • “Que traduções estão em falta para o francês?” — Liste o conteúdo em falta ou com falhas e solicite traduções após a sua aprovação.

A sua IA irá instruí-lo a criar a chave secreta do SDK no painel de controlo e a colá-la no .env Você mesmo. O MCP nunca cria ou mostra chaves secretas.

Se o seu editor utilizar campos separados

Campo do editorO que inserir
Server namealtifiedServer URLhttps://mcp.altified.com/mcpHeader nameAuthorizationHeader valueBearer YOUR_MCP_TOKEN

O token é privado

Trate o token MCP como uma palavra-passe. Não o coloque no Git, numa issue pública, numa captura de ecrã, no código-fonte do frontend ou num NEXT_PUBLIC_ variável de ambiente. Se estiver exposta, revogue-a em Altified e crie uma substituta.

Se não ligar

  • O servidor não aparece: Confirme se o editor é compatível com MCP e, em seguida, reinicie-o ou recarregue-o.
  • Não autorizado ou 401: Copie novamente a configuração, verifique se o token está completo e certifique-se de que não foi revogado.
  • Permissão negada ou erro 403: voltar a Altified e criar um token com a permissão necessária. Um token de projeto também não pode aceder a outro projeto.
  • A IA não pode mudar nada: verificar se o token tem a permissão de escrita necessária e aprovar a ação solicitada quando Altified pedir confirmação.

O que significam as permissões

  • projects:read — permite que a IA veja os nomes dos projetos, domínios, idiomas e estados.
  • languages:read — permite que a IA veja os idiomas que o Altified suporta.
  • translations:read — permite à IA ver o progresso da tradução.
  • seo:read — permite que a IA leia o estado e as conclusões da auditoria SEO.
  • integration:read — permite que a IA leia informações seguras de configuração do SDK.
  • usage:read — permite que a IA leia informações de planeamento e utilização.
  • projects:write — permite que a IA solicite alterações no projeto e no seletor de idioma, incluindo a publicação do seletor.
  • languages:write — permite que a IA solicite a adição ou remoção de um idioma.
  • translations:write — permite à IA solicitar, tentar novamente ou editar traduções, utilizando a sua quota de tradução.

Cada gravação requer ainda a sua confirmação. Altified verifica também a propriedade do projeto, as permissões do token e os limites do plano. seo:write Está reservado para ações futuras.

O que a MCP não faz

  • Não substitui o painel de controlo ou o SDK Altified.
  • Não fornece à IA a sua base de dados, detalhes de pagamento ou segredos de back-end.
  • Não edita automaticamente a sua base de código; a ferramenta de codificação com IA faz alterações no código localmente.
  • Não permite que um token de projeto aceda a outro projeto Altified.

Revogando o acesso

Voltar ao projeto MCP Na página, encontre o token e escolha RevogarA ferramenta de IA deixará de conseguir conectar-se com este token. Crie um novo token se perder o antigo ou o partilhar acidentalmente.

Precisa da integração normal da aplicação? Continue com o Guia de configuração do SDK.