Ir al contenido
Documentation

Servidores MCP en el agente de IA

Los servidores MCP (Model Context Protocol) proporcionan herramientas adicionales al agente. El agente admite dos tipos:

TipoDónde se ejecutaDónde se configura
AlojadoFuera de su equipo; se conectaCHAMPREP a él a través de HTTPSSu CHAMPREP AIcuenta, compartida con las aplicaciones web, de escritorio y móviles
LocalUn programa ejecutado en su equipo, que se comunica mediante MCP a través de la entrada y salida estándarUn mcp.json Archivo para usted o para el proyecto

Esta página trata sobre la conexión de servidores al agente. Para utilizar CHAMPREPCHAMPREP desde otro cliente MCP, consulte el CHAMPREP Servidor MCP.

/mcp

La ventana muestra una lista de todos los servidores alojados y locales con su estado y herramientas. Seleccione un servidor con las teclas de flecha y pulse:

ClaveAcción
EnterMostrar las acciones del servidor.
eActive o desactive el servidor.
rActualizar: se vuelve a conectar y se recargan sus herramientas.
aReautenticación: sustituya sus credenciales.
tEnumere sus herramientas.
xElimine el servidor.
nAñada un servidor.

Los atajos también funcionan sin la ventana, por ejemplo /mcp list, /mcp enable NAME, /mcp disable NAME, /mcp refresh NAME, y, en el caso de los servidores locales, /mcp restart NAME y /mcp remove NAME.

Los servidores alojados pertenecen a su cuentaCHAMPREP AI, por lo que un servidor que añada en la terminal también estará disponible en la web, y viceversa. Sus herramientas se ejecutan en CHAMPREP, no en su equipo.

Para añadir uno, pulse n en /mcp, seleccione un servidor alojado e introduzca su URL y credencial, como un token de portador. La credencial se introduce en un campo enmascarado, se envía una sola vez a su CHAMPREP AIcuenta y nunca se muestra, se guarda localmente, se registra ni se facilita al modelo. Utilice a para sustituir una credencial caducada.

Al eliminar un servidor alojado, este se elimina de su cuenta en todas las plataformas. Si una acción de servidor alojado no está disponible desde el CLIen su entorno, el agente se lo indicará; utilice en su lugar su configuraciónCHAMPREP AI en la web.

Los servidores locales son programas que el agente inicia en su equipo. Añada uno con n en /mcp y seleccione:

  • el nombre del servidor y el comando con sus argumentos;
  • solo para usted (su usuario mcp.json) o para este proyecto (.champrep/mcp.json, que puede confirmar);
  • Opcionalmente, una variable de entorno que contenga una credencial. Su valor queda enmascarado, se almacena únicamente en su cuenta de usuario mcp.json, y nunca se escriben en un archivo de proyecto , en el historial, en los registros ni en el contexto del modelo.

También puede editar los archivos directamente. Utilizan el formato común del cliente MCP. Guarde las credenciales en su archivo de usuario, nunca en un archivo de proyecto que vaya a confirmar:

{
"mcpServers": {
"github": {
"command": "github-mcp-server",
"args": ["stdio"],
"env": { "GITHUB_TOKEN": "YOUR_TOKEN" }
}
}
}

Campos opcionales por servidor: disabled, include_tools, exclude_tools, startup_timeout_sec (por defecto 30), tool_timeout_sec (por defecto 120, máximo 600) y priority. En estos archivos solo deben figurar los servidores locales (stdio); añada los servidores HTTP como servidores alojados.

Los servidores locales nunca reciben sus CHAMPREPcredenciales ni ninguna CHAMPREP_* variable de entorno.

Ejecutar champrep ai paths para encontrar a su usuario mcp.json. Los servidores MCP locales son una característica del plan; consulte Planes y límites.

Un proyecto .champrep/mcp.json ejecuta comandos en su equipo, por lo que sus servidores solo se inician después de que usted haya dado su confianza al proyecto .champrep/ configuración. Si el archivo cambia, se le volverá a preguntar. Consulte Confianza del repositorio.

Aprobación de llamadas a la herramienta MCP

Sección titulada «Aprobación de llamadas a la herramienta MCP»
  • Herramientas del servidor local se tratan como comandos: cada llamada solicita su permiso, mostrando el servidor y los argumentos, a menos que una regla de permiso lo cubra . Por ejemplo, local_mcp__github__* permite el uso de todas las herramientas de la github servidor. Las reglas de denegación funcionan de la misma manera.
  • Herramientas de servidor alojado Siga la configuración de aprobación del servidor de su CHAMPREP AI cuenta. Cuando una llamada requiera aprobación, el agente mostrará una ficha de aprobación; nada se aprueba automáticamente.

El agente puede ofrecer un máximo de 64 herramientas locales por turno. Cuando los servidores locales proporcionen más, las de menorpriority Los servidores se filtran en primer lugar y el agente se lo indica a usted. Utilice include_tools o exclude_tools para conservar las herramientas que necesita.