yourept-mcp

Servidor MCP para el CRM YOUREPT. Se conecta a Claude, Cursor, Codex y otros clientes MCP y da al agente acceso a los datos del panel de administración: solicitudes, estudiantes, profesores, lecciones, pagos, pagos a profesores e informes financieros.

Preguntas para las que existe:

«¿Cuánto ganamos este mes y cuánto se fue en pagos a profesores?» «¿Qué solicitudes están vencidas y de qué gerentes?» «Muestra los estudiantes que no han tenido lecciones en dos semanas» «¿Qué profesores no han firmado el acuerdo en Рокет Ворк?»

Es decir, lo que en la interfaz requeriría abrir tres secciones y cuadrar los números a mano.

Instalación

1. Obtenga la clave

En el panel de administración: Configuración → Claves API → Crear clave. La clave se muestra una sola vez — cópiela de inmediato. Si la pierde, emita una nueva y revoque la anterior.

La clave funciona en nombre del empleado que la emitió y con sus permisos: las secciones cerradas para la persona también están cerradas para el agente. La clave de «solo lectura» (por defecto) físicamente no puede cambiar nada en el CRM.

2. Configure el servidor en su programa

No necesita instalar nada por separado: npx descargará el paquete por sí mismo.

El paquete se instala directamente desde GitHub. Después de la publicación en npm, en lugar de github:Skamatoz/yourept-mcp se podrá escribir simplemente yourept-mcp.

Claude Desktop — Configuración → Developer → Edit Config:

{
  "mcpServers": {
    "yourept": {
      "command": "npx",
      "args": ["-y", "github:Skamatoz/yourept-mcp"],
      "env": {
        "YOUREPT_API_URL": "https://api-admin.yourept.ru",
        "YOUREPT_API_KEY": "yrp_live_ваш_ключ"
      }
    }
  }
}

Claude Code:

claude mcp add yourept \
  --env YOUREPT_API_URL=https://api-admin.yourept.ru \
  --env YOUREPT_API_KEY=yrp_live_ваш_ключ \
  -- npx -y github:Skamatoz/yourept-mcp

Cursor — archivo ~/.cursor/mcp.json, el mismo formato que en Claude Desktop.

Codex — archivo ~/.codex/config.toml:

[mcp_servers.yourept]
command = "npx"
args = ["-y", "github:Skamatoz/yourept-mcp"]

[mcp_servers.yourept.env]
YOUREPT_API_URL = "https://api-admin.yourept.ru"
YOUREPT_API_KEY = "yrp_live_ваш_ключ"

Después de editar la configuración, debe reiniciar el programa.

Related MCP server: mcp-server-salesforce

Qué puede hacer

Los montos se entregan en rublos, la hora es de Moscú.

Si algo no funciona

«Clave no válida» — la clave fue revocada, caducó o se copió con pérdida de caracteres. Verifíquela en el panel de administración y, si es necesario, emita una nueva.

«Permisos insuficientes» — el empleado para quien se emitió la clave no tiene acceso a esta sección. Pregunte al agente whoami: le mostrará qué secciones están abiertas.

«La clave se emitió solo de lectura» — es de esperar: la clave por defecto no cambia nada.

«El panel no respondió» — verifique YOUREPT_API_URL. Se necesita la dirección por la que funciona la API (normalmente comienza con api-), no la dirección del sitio del panel en sí.

El servidor no apareció en la lista — casi siempre es un paréntesis sin cerrar o una coma de más en la configuración. En el panel, en la pantalla de emisión de la clave, hay un fragmento listo para copiar completo.

Seguridad

• En la base de datos solo se almacena el hash de la clave: no se puede recuperar la clave a partir de él.

• La clave hereda los permisos de su empleado y no puede excederlos.

• Con la clave no se pueden gestionar claves: no se podrá emitir un nuevo acceso a través de la API.

• La revocación es inmediata.

• Los datos personales que no están en la interfaz (transcripciones de las lecciones de prueba) no están disponibles a través de este servidor.

Al despedir a un empleado, revoque sus claves junto con la cuenta.

Desarrollo

pnpm install
pnpm build     # tsc → dist/

Probar el servidor sin conectarlo a un cliente:

printf '%s\n' \
  '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"t","version":"1"}}}' \
  '{"jsonrpc":"2.0","method":"notifications/initialized"}' \
  '{"jsonrpc":"2.0","id":2,"method":"tools/list"}' \
  | YOUREPT_API_URL=http://localhost:4001 YOUREPT_API_KEY=ключ node dist/index.js

El diagnóstico va a stderr; en stdout solo el protocolo, no se puede escribir allí.