Paso 7 de 25
Conecta una herramienta de codificación de IA a Altified
MCP permite que herramientas como Cursor, Claude y los agentes de VS Code pregunten Altified sobre este proyecto y realicen acciones aprobadas para usted.
MCP significa Protocolo de contexto del modeloEn lenguaje sencillo, es una conexión segura entre una herramienta de codificación de IA y su proyecto Altified. La herramienta de IA no se conecta directamente a su base de datos. Se comunica con el servidor MCP Altified, que verifica su token y permisos antes de usar Altified.
La conexión se ve así:
Tu herramienta de IA → Altified Servidor MCP → Tu proyecto Altified
¿Qué son los ajustes de MCP?
La configuración de MCP es el lugar dentro de un editor de código de IA donde agregas herramientas externas para que las use la IA. No es una configuración en el panel Altified. Busca en tu editor un menú o archivo llamado MCP, Servidores MCP, Herramientas, o Integraciones.
El editor debe ser compatible con MCP. Un editor de texto normal sin asistente de IA no puede usar esta conexión.
Configúralo de principio a fin.
- Abre tu proyecto. En el panel de control Altified, abra el proyecto que desea que utilice su herramienta de codificación de IA y, a continuación, seleccione MCP desde las tarjetas del proyecto o la navegación del proyecto.
- Seleccione los permisos. Elegir Deja que mi IA configure las cosas si quieres que la IA se integre Altified por ti, o Solo lectura Si solo debería inspeccionar tu proyecto. Cada cambio aún requiere tu confirmación.
- Crea un token. Dale un nombre como por ejemplo
Cursor on my laptopLos tokens creados a partir de un proyecto están limitados a ese proyecto. - Copia el token inmediatamente. Altified muestra el token completo solo una vez. Funciona como una contraseña para la herramienta de IA.
- Agrega Altified a tu editor. Después de que se crea el token, seleccione su editor en el panel de tokens. Cursor y VS Code tienen un Instalar botón; Claude Code te da un comando para ejecutar; otros editores obtienen JSON con tu token ya completado.
- ¿Utilizas otro editor? Buscar su configuración para
MCP, luego elige una opción como Agregar servidor, Nuevo servidor MCP, o Editar configuraciónLa redacción es diferente en cada editor. - Pegue y guarde la configuración. Si el editor acepta JSON, pegue la configuración que copió de Altified. Si solicita campos separados, use la URL del servidor, el
Authorizationencabezado y el token que se muestra a continuación. - Reinicia o recarga el editor. Algunos editores solo se conectan a nuevos servidores MCP después de reiniciar el asistente de IA o el editor. Apruebe o habilite el servidor Altified si el editor lo solicita.
- Pídele que integre Altified. Abre la carpeta de tu aplicación en el editor y pregunta: “Integrar Altified en este proyecto.” La IA lee las instrucciones de configuración de tu proyecto, te muestra un plan, espera tu aprobación, luego instala el SDK, coloca el selector de idioma y comprueba que el SDK esté conectado.
Run in your project's terminal.
claude mcp add --transport http altified https://mcp.altified.com/mcp \ --header "Authorization: Bearer YOUR_MCP_TOKEN"
Los ejemplos anteriores utilizan YOUR_MCP_TOKEN Como marcador de posición. La página MCP de tu proyecto rellena automáticamente tu token real. Nunca publiques la configuración completa.
Otras cosas que preguntar
- “Realiza una revisión del estado de mi proyecto Altified.” — Conexión SDK, clave secreta, selector, progreso de la traducción, uso y la última auditoría SEO.
- “Ayúdame a configurar el selector de idioma Altified.” — Revisa los idiomas, el orden, las etiquetas y el estilo, y luego publica después de dar tu aprobación.
- “¿Qué traducciones faltan para el francés?” — Enumere el contenido que falta o que no ha funcionado y solicite traducciones después de su aprobación.
Tu IA te dirá que crees la clave secreta del SDK en el panel de control y la pegues en .env MCP nunca crea ni muestra claves secretas.
Si su editor utiliza campos separados
Server namealtifiedServer URLhttps://mcp.altified.com/mcpHeader nameAuthorizationHeader valueBearer YOUR_MCP_TOKENEl token es privado
NEXT_PUBLIC_ variable de entorno. Si está expuesta, revoque su estado en Altified y cree un reemplazo.Si no se conecta
- El servidor no aparece: Confirma que el editor sea compatible con MCP y, a continuación, reinícialo o recárgalo.
- No autorizado o 401: Copia la configuración de nuevo, comprueba que el token esté completo y asegúrate de que no haya sido revocado.
- Permiso denegado o error 403: Regresa a Altified y crea un token con el permiso requerido. Un token de proyecto tampoco puede acceder a otro proyecto.
- La IA no puede cambiar nada: verifica que el token tenga el permiso de escritura requerido y aprueba la acción solicitada cuando Altified pida confirmación.
Qué significan los permisos
projects:read— permite que la IA vea los nombres de los proyectos, los dominios, los idiomas y el estado.languages:read— permite que la IA vea los idiomas que Altified admite.translations:read— permite que la IA vea el progreso de la traducción.seo:read— permite que la IA lea el estado y los resultados de la auditoría SEO.integration:read— permite que la IA lea la información de configuración segura del SDK.usage:read— permite que la IA lea la información del plan y del uso.projects:write— permite que la IA solicite cambios en el selector de proyectos e idiomas, incluida la publicación del selector.languages:write— permite que la IA solicite agregar o eliminar un idioma.translations:write— permite que la IA solicite, vuelva a intentar o edite traducciones, utilizando tu límite de traducciones.
Cada escritura aún requiere tu confirmación. Altified también verifica la propiedad del proyecto, los permisos del token y los límites del plan. seo:write Está reservado para acciones futuras.
Lo que MCP no hace
- No reemplaza el panel de control Altified ni el SDK.
- No le proporciona a la IA su base de datos, detalles de pago ni secretos del sistema.
- No edita automáticamente tu código fuente; la herramienta de codificación con IA realiza los cambios de código localmente.
- No permite que un token de proyecto acceda a otro proyecto Altified.
Revocar el acceso
Regresar al proyecto MCP página, encuentra el token y elige RevocarLa herramienta de IA dejará de poder conectarse con ese token. Crea un nuevo token si pierdes el anterior o lo compartes accidentalmente.
¿Necesita la integración de aplicación normal? Continúe con el Guía de configuración del SDK.