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.
- 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.
- 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.
- Criar um token. Dê um nome como...
Cursor on my laptopOs tokens criados a partir de um projeto estão limitados a esse projeto. - Copie o token imediatamente. Altified mostra o token completo apenas uma vez. Funciona como uma password para a ferramenta de IA.
- 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.
- 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. - 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
Authorizationcabeçalho e o token apresentado abaixo. - 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.
- 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
Server namealtifiedServer URLhttps://mcp.altified.com/mcpHeader nameAuthorizationHeader valueBearer YOUR_MCP_TOKENO token é privado
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.