Ir al contenido
Documentation

Servidor MCP (conecte su asistente de IA)

CHAMPREP alberga un servidor remoto Protocolo de contexto de modelo servidor (MCP). Conéctelo a cualquier cliente de IA compatible con MCP —Claude (claude.ai y versión de escritorio), ChatGPT, Claude Code, Codex, Cursor, VS Code, Windsurf y otros— y su asistente podrá actuar en su CHAMPREP cuenta: anote y gestione eventos del calendario, lea y redacte correos, gestione tableros de trabajo, busque en su unidad de almacenamiento, cree facturas, notas, documentos y hojas de cálculo, y mucho más, todo mediante conversación.

:::advertencia[Punto final actualizado: utilice /mcp/v1] El punto final ahora es con versión. Conéctese a https://ai-api.champrep.com/mcp/v1. El antiguo sin versión https://ai-api.champrep.com/mcp es retirado — las solicitudes dirigidas a él se rechazan con un mensaje en el que se le indica que cambie. Si su cliente sigue apuntando a /mcp, cambie la URL a /mcp/v1 (Los usuarios de npm-bridge en npx -y @champrep/mcp detectarán automáticamente el nuevo punto final en su próxima ejecución). :::

No es necesario instalar nada para los clientes modernos. El servidor está alojado en:

https://ai-api.champrep.com/mcp/v1

El razonamiento del asistente se ejecuta en su cliente de IA con el modelo de su cliente: CHAMPREP las llamadas MCP no consumen ninguno de sus CHAMPREP AI créditos. Cada llamada a la herramienta se ejecuta con su propia identidad y está sujeta a su plan, a las políticas de su organización y (en el caso de las APIclaves) a los ámbitos que haya elegido.

Hay dos formas de conectarse. Ambas son totalmente compatibles; elija según la situación:

Inicio de sesión a través del navegador (OAuth)API clave
Ideal paraUsuarios que utilizan una aplicación de IA de forma interactivaScripts, CI, servidores, herramientas sin interfaz gráfica
ConfiguraciónPegue la URL; apruébela en su navegadorCree una clave una vez; pégela en la configuración
Secretos que debe gestionarNinguna: ninguna clave llega a la configuración del clienteUsted almacena la cpk_… clave en la configuración del cliente
Ámbito de accesoSu cuenta completa (como si hubiera iniciado sesión)Solo el ámbitos usted concede la clave (p. ej., solo calendar:read)
Funciona enclaude.ai, Claude Desktop, ChatGPT, Claude Code, Codex, Cursor, VS Code, WindsurfTodo, incluidos los clientes que no dispongan de navegador
CaducidadLas sesiones se actualizan automáticamente; revóquelas en cualquier momentoFecha de caducidad opcional; revocación en cualquier momento
Revocar desdeDesconéctese en el clienteCuenta → APIClaves en champrep.com

Regla general: Si hay una persona frente al cliente, utilice el inicio de sesión a través del navegador. Si se trata de una máquina, utilice una claveAPI de API con los ámbitos más restringidos que sean suficientes para realizar la tarea.

Opción A: Inicie sesión con su navegador (recomendado)

Sección titulada «Opción A: Inicie sesión con su navegador (recomendado)»

Añada la URL del servidor con sin clave ni encabezados. Su cliente detecta el CHAMPREPflujo de inicio de sesión automáticamente (OAuth 2.1 con registro dinámico), abre su navegador en una página de consentimientoCHAMPREP y se conecta una vez que usted lo apruebe. Si ya ha iniciado sesión en CHAMPREPen ese navegador, accederá directamente a la pantalla de aprobación; si ha iniciado sesión en varias CHAMPREPcuentas, podrá elegir cuál desea conectar.

  1. Configuración → Conectores → Añadir conector personalizado.
  2. Pegue https://ai-api.champrep.com/mcp/v1 y guarde los cambios.
  3. Su navegador abrirá la página de consentimientoCHAMPREP: revíselo y haga clic en Permitir.
  4. En cualquier chat, active el CHAMPREPconector desde el menú de herramientas y simplemente pregunte: «Compruebe mi correoCHAMPREP en busca de mensajes no leídos».

Los conectores requieren un plan de ChatGPT con modo desarrollador (Configuración → Conectores → Avanzado → Modo desarrollador).

  1. Configuración → Conectores → Crear (o Añada un conector).
  2. Asigne un nombre CHAMPREP, configure la URL del servidor MCP en https://ai-api.champrep.com/mcp/v1, elija OAuth autenticación y guarde los cambios.
  3. Acepte la página de consentimientoCHAMPREP cuando se abra el navegador.
Ventana de terminal
claude mcp add --transport http champrep https://ai-api.champrep.com/mcp/v1

A continuación, ejecute /mcp, seleccione champrep, y elija Autentíquese — Su navegador abre la página de consentimiento.

Configuración → MCP → Añadir nuevo servidor MCP, o añada a ~/.cursor/mcp.json:

{
"mcpServers": {
"champrep": { "url": "https://ai-api.champrep.com/mcp/v1" }
}
}

Cuando Cursor le indique que el servidor requiere autenticación, siga las instrucciones de inicio de sesión.

Añada un servidor MCP HTTP con la URL https://ai-api.champrep.com/mcp/v1 en la configuración del MCP del cliente. Ambos admiten el flujo OAuth: la primera conexión abre la página de consentimientoCHAMPREP.

  1. Inicie sesión en champrep.com y abra Cuenta → APIClaves.
  2. Cree una clave y seleccione sus ámbitos — estos parámetros determinan qué herramientas puede utilizar el asistente. calendar:read muestra herramientas de calendario de solo lectura; calendar:write también muestra herramientas que crean o modifican eventos. Conceda acceso únicamente a los servicios que desee que sean accesibles.
  3. Copie la clave (cpk_live_…). Se muestra una sola vez.

Código de Claude:

Ventana de terminal
claude mcp add --transport http champrep https://ai-api.champrep.com/mcp/v1 \
--header "Authorization: Bearer cpk_live_YOUR_KEY"

Cursor / VS Code / Windsurf (mcp.json(configuración de tipo):

{
"mcpServers": {
"champrep": {
"url": "https://ai-api.champrep.com/mcp/v1",
"headers": { "Authorization": "Bearer cpk_live_YOUR_KEY" }
}
}
}

Codex CLI (~/.codex/config.toml) — Codex se comunica con los servidores stdio, por lo que debe utilizar el paquete «bridge»:

[mcp_servers.champrep]
command = "npx"
args = ["-y", "@champrep/mcp"]
env = { CHAMPREP_API_KEY = "cpk_live_YOUR_KEY" }

Claude Desktop (configuración stdio) y otros clientes exclusivos de stdio — el @champrep/mcp «bridge» reenvía un servidor stdio local al punto de acceso alojado:

{
"mcpServers": {
"champrep": {
"command": "npx",
"args": ["-y", "@champrep/mcp"],
"env": { "CHAMPREP_API_KEY": "cpk_live_YOUR_KEY" }
}
}
}

Si CHAMPREP_API_KEY si falta, el puente abre su navegador en la páginaAPI «Claves» y muestra las instrucciones en lugar de fallar de forma silenciosa.

HTTP sin formato (para sus propias integraciones: JSON-RPC 2.0 sin formato). Pase la clave desde una variable de entorno en lugar de hacerlo en línea, para que no quede registrada en el historial de su shell:

Ventana de terminal
export CHAMPREP_API_KEY="cpk_live_..." # from Account -> API Keys
curl https://ai-api.champrep.com/mcp/v1 \
-H "Authorization: Bearer $CHAMPREP_API_KEY" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Su cliente MCP controla si, cuándo y cómo le solicita que confirme una llamada a una herramienta . El Directrices sobre la interacción con el usuario de la especificación MCP recomienda la supervisión humana y las solicitudes de confirmación, pero no exige un modelo de interacción concreto. La solicitud de confirmación depende del cliente y de su configuración, incluidos los permisos guardados o las reglas de aprobación automática.

CHAMPREP proporciona anotaciones de herramientas para ayudar a los clientes a evaluar cada operación:

  • Herramientas de solo lectura (enumerar eventos, buscar en el correo, leer notas…) tienen readOnlyHint: true.
  • Herramientas que modifican elementos (enviar correo, crear eventos, cargar archivos…) tienen readOnlyHint: false.
  • Herramientas destructivas tiene destructiveHint: true y permanezcan oculta a menos que se haya habilitado el acceso destructivo (siguiente sección).

Las anotaciones de las herramientas describen su comportamiento. No imponen un cuadro de diálogo de confirmación ni garantizan que aparezca un aviso antes de cada llamada, ni siquiera en el caso de herramientas destructivas. Revise la configuración de aprobación de su cliente antes de permitir cambios.

Para las acciones habituales de MCP, se basaCHAMPREP en la gestión del consentimiento del cliente en lugar de requerir una segunda tarjeta de aprobaciónCHAMPREP. El servidor no verifica de forma independiente que el cliente haya mostrado una solicitud de confirmación.

CHAMPREP Sigue aplicando las restricciones de conexión, los ámbitos de APIclave aplicables, la autorización de servicios, las políticas de la organización y los límites de frecuencia. Las acciones enrutadas a través CHAMPREPdel ejecutor de acciones de también se someten a comprobaciones de seguridad y se registran en su cuenta Registro de actividad, con Deshacer cuando sea compatible. El consentimiento del cliente no puede anular un rechazo por parte del servidor ni una aprobación exigida por la organización; las acciones que requieran una aprobación CHAMPREPespecífica pueden ser denegadas a través de MCP.

Activación de herramientas destructivas (opcional)

Sección titulada «Activación de herramientas destructivas (opcional)»

De forma predeterminada, el servidor oculta las herramientas que eliminan o borran datos de forma permanente — como eliminar carpetas de la unidad, purgar notas, eliminar registros y acciones similares. Si tiene que realizar una limpieza real y desea la ayuda de su asistente, la conexión debe permitir acciones destructivas y el cliente debe solicitarlas añadiendo ?destructive=true a la URL del servidor:

https://ai-api.champrep.com/mcp/v1?destructive=true

Utilice esa URL en cualquier lugar donde se acepten direcciones URL (conector de claude.ai, Claude Code, Cursor, ChatGPT). Para el puente stdio, configure en su lugar una variable de entorno:

"env": {
"CHAMPREP_API_KEY": "cpk_live_YOUR_KEY",
"CHAMPREP_ENABLE_DESTRUCTIVE": "true"
}

La configuración de la bandera de URL o del puente, por sí sola, no anula los permisos de la conexión. Una conexión de solo lectura, un servicio no permitido o un acceso destructivo desactivado siguen impidiendo que la herramienta esté disponible.

Usted es responsable de lo que su asistente haga con estas herramientas. Es posible que los datos eliminados no sean recuperables. Las herramientas destructivas siguen requiriendo los ámbitos de clave API adecuados, como los de un servicio :write ámbito o su ámbito de eliminación independiente cuando proceda. Siguen teniendo destructiveHint, pero el hecho de que vea una solicitud de confirmación depende de su cliente y de su configuración. Las comprobaciones del lado del servidor y la auditoría de acciones descritas anteriormente siguen siendo aplicables. Algunas acciones destructivas admiten Deshacer desde la página «Actividad» de su cuenta; sin embargo, considere cada eliminación como definitiva.

Independientemente de este indicador, hay algunas cosas que son nunca Disponible a través de MCP: operaciones administrativas, herramientas de ejecución de código y eliminación de cuentas. Las únicas excepciones a la norma de ejecución de código son el inicio de una compilación de vista previa de QA o una sesión de IDE en la nube de QA: ambas se ejecutan en el entorno aislado de QA, tras su aprobación (véase MCP para Código, CI, Runner Farm y QA).

Las herramientas abarcan toda la plataforma, siempre como usted: Calendar (eventos, reservas, disponibilidad), Mail (leer, buscar, borrador, enviar, etiquetas, reglas), Drive (buscar, archivos, carpetas, compartir), Notes, Meetings (programación, resúmenes, grabaciones), Work (tableros, tickets), Docs (documentos, comentarios, ediciones sugeridas, versiones, exportación), Hojas de cálculo (libros de trabajo, rangos, fórmulas, formato, validación, formato condicional, protección, comentarios, versiones, exportación), Facturas, Forms, Contacts, Gráficos, CHAMPREP Código, Granja de ejecutores, Control de calidad y Learn. Las herramientas que aparecen exactamente dependen de su plan, de las políticas de su organización, de sus permisos de IA por servicio y (en el caso de las clavesAPI) de los ámbitos de la clave.

Para CHAMPREP Code (proyectos, planes de clonación, pipelines, registros de tareas, ejecutores), Runner Farm y QA, consulte MCP para Código, CI, Runner Farm y QA: lo que puede hacer el asistente, ejemplos de indicaciones, lo que requiere su aprobación y lo que permanece en las aplicaciones web.

Pruebe primero lo siguiente:

  • «¿Qué hay en mi CHAMPREPcalendario esta semana?»
  • «¿Tengo correo sin leer? Resuma todo lo importante».
  • «Busque en mi unidad los contratos en formato PDF de este mes».
  • «Cree un ticket de trabajo titulado “Renovar certificados SSL” en mi panel de operaciones».
  • «Cree un documento de Docs denominado “Plan del 4.º trimestre” con secciones para objetivos, riesgos y responsables».
  • «En mi libro de cálculo “Presupuesto mensual”, resalte todos los gastos superiores a 500».

Browser Relay Bridge (extensión de Chrome) y Eve AI

Sección titulada «Browser Relay Bridge (extensión de Chrome) y Eve AI»

Además de las herramientas de servicios en la nube, el CHAMPREP para la extensión de Chrome Puede conectar su propio navegador a Eve:

  • Activar Permita que Eve utilice este navegador en la configuración de la extensión.
  • Eve permite chatear en la web, en la aplicación de escritorio, en Eve AI para VS Code, y en el agente de terminal (eve / champrep ai) puede, a continuación, leer la pestaña activa, mostrar una lista de pestañas y realizar capturas de pantalla y, tras su aprobación de cada acción, navegar, hacer clic o rellenar un campo.
  • Eve nunca realiza acciones en sitios web de correo electrónico, banca, pagos o inicio de sesión, y nunca introduce datos en campos de contraseña, códigos de un solo uso o datos de tarjetas.

  • API claves — Ver, ampliar el ámbito, caducar y revocar en Cuenta → APIClaves. La revocación surte efecto de forma inmediata.
  • Inicios de sesión en el navegador — Desconecte el conector dentro del cliente de IA. También puede cerrar la sesión CHAMPREPen ese navegador; de este modo, ya no se podrán emitir nuevos tokens para él.
  • Cada acción de tipo «agente» aparece en su cuenta Registro de actividad con qué se ha ejecutado, cuándo y desde dónde, así como la opción «Deshacer» cuando sea compatible.

  • 120 solicitudes MCP por minuto por identidad. Para una automatización más compleja, se recomienda utilizar la desarrollador API con claves de ámbito de servicio.
  • Las llamadas de la herramienta se someten a las mismas cuotas por plan que el resto de su cuenta: un asistente no puede superar lo que usted mismo puede hacer.

SíntomaPosible causa y solución
El cliente indica que se requiere autenticación y no se abre nadaEs posible que su cliente no sea compatible con MCP OAuth; utilice una claveAPI (Opción B).
Invalid API keyLa clave ha sido revocada, ha caducado o se ha escrito incorrectamente. Cree una nueva en Cuenta → APIClaves.
Unknown or unavailable toolLa herramienta se encuentra fuera de los ámbitos de su clave, está desactivada por sus permisos de IA o de conexión, o es destructiva si carece tanto del permiso de conexión como de la ?destructive=true consentimiento expreso.
Una herramienta se ejecuta sin solicitud de confirmaciónLas solicitudes de confirmación las controla su cliente MCP y su configuración de aprobación. Las anotaciones de las herramientas, incluidas destructiveHint, no garantizan que se muestre un mensaje de confirmación. Revise los permisos guardados y las reglas de aprobación automática en ese cliente.
Se rechaza una herramienta de escritura con un mensaje de límiteLos controles de acceso del lado del CHAMPREPservidor (límites diarios, protección contra abusos) lo han rechazado; el mensaje indica el motivo. Inténtelo más tarde o reduzca el volumen.
La página de consentimiento indica «Sesión caducada»La autorización ha permanecido activa durante demasiado tiempo. Vuelva a ejecutar el flujo de conexión desde el cliente.
Funciona en la prueba del navegador, pero no desde un servidor o CI Utilice una clave de API: el inicio de sesión en el navegador solo genera tokens de forma interactiva. Respuestas Ha alcanzado el límite por minuto; reduzca la carga y vuelva a intentarlo. Puntos de conexión: producción · entorno de pruebasUtilice una claveAPI: el inicio de sesión en el navegador solo genera tokens de forma interactiva.
429 RespuestasHa alcanzado el límite por minuto; espere un poco y vuelva a intentarlo.

Punto final: https://ai-api.champrep.com/mcp/v1.