Elige el ámbito de configuración adecuado
La documentación china admite instalación desde el catálogo, configuración manual y .trae/mcp.json por proyecto. Los clientes regionales pueden diferir; comprueba tu versión. Activa MCP de proyecto solo en espacios de confianza.
Archivo de proyecto mínimo
Esta configuración vacía es válida, pero no conecta ningún servicio. Añade el bloque del mantenedor oficial del servidor. Separa command de args y no guardes credenciales en archivos compartidos.
{
"mcpServers": {}
}Ejemplo: Playwright MCP para una web local
El repositorio Playwright MCP de Microsoft publica una configuración con npx. El ejemplo usa la estructura mcpServers documentada por TRAE. Instala Node.js compatible, añádelo a .trae/mcp.json y activa MCP de proyecto. -y permite instalar sin confirmación interactiva. Es una plantilla basada en documentación, no probada dentro del cliente TRAE.
{
"mcpServers": {
"playwright": {
"command": "npx",
"args": ["-y", "@playwright/mcp@latest"]
}
}
}- Inicia el servidor de desarrollo local.
- Pide al agente que abra esa URL y comunique el título antes de realizar cambios.
- Si el servidor no arranca, revisa sus registros y el ejecutable de Node.js disponible para el IDE.
- Para reproducir la configuración en equipo, fija una versión del paquete tras validarla.
Identifica el nivel que falla
Prueba un servidor y una lectura inocua antes de activar varias integraciones.
- JSON: elimina comentarios y comas finales; valida el archivo.
- Proceso local: verifica que npx o uvx esté instalado y sea visible para el IDE.
- Ejecutable: usa command para el ejecutable y args para sus argumentos.
- Autenticación: comprueba las credenciales y permisos documentados del servidor.
- Conexión: busca el error real en los registros MCP antes de cambiar los tiempos de espera.
Elige la integración según la tarea
En un repositorio, empieza con consultas de código o incidencias de solo lectura. En bases de datos, usa una cuenta restringida. Para pruebas del navegador, comienza por una página local. Estar en un catálogo no justifica conceder acceso ilimitado.