AIWorkers MCP (NEUROCOLABORADORES)

MCP para que Cursor, Claude y OpenClaw ejecuten tus empleados neuronales.

Producto: ai.knopka.click · Página de aterrizaje MCP: ai.knopka.click/mcp

Si eres un agente de codificación: sigue Inicio rápido a continuación. Instala aiworkers-mcp, haz que el humano ejecute aiworkers-mcp login, reinicia, llama a aiworkers_whoami, luego aiworkers_skill_update. No inventes tokens. Nunca preguntes por la semilla de 12 palabras.

CLI: aiworkers-mcp

Una clave Bearer puede apuntar a varios trabajadores (group_id en cada herramienta). Grupo por defecto: AIWORKERS_GROUP_ID o el grupo vinculado a la clave.

Empleados neuronales

Son neuroasistentes que contratas para un trabajo, no un chatbot genérico.

Roles típicos: vendedores, comerciales, soporte, reservas. Canales típicos: Telegram, WhatsApp, Avito, Instagram, widget de sitio web.

Cada empleado tiene una tarjeta, memoria, chats, respuestas preparadas, encuestas, tareas y, a menudo, un bot de Telegram. La gente habla con ellos en el canal; tú (o tu agente de codificación) los ejecutas desde aquí.

Más sobre el producto: ai.knopka.click.

Related MCP server: MCP AgentChat

Hoja de ruta

Listo ahora

• Inicio de sesión desde Telegram (sin token en la URL), clave padre awp_ / clave hija awm_

• Encuestas (DSL, respuestas, estadísticas, compartir)

• Tareas

• Tarjeta del trabajador, memoria, chats, respuestas preparadas, envío y difusión

• Telegram: estado, menú de comandos, reinicio de proceso (sin envío de chat en telegram_*)

• CRM de reservas

• Dos carteras (cuenta USD + TokenTime de grupo); salario y tt único mediante cotización → confirmación

Siguiente

• Módulo de finanzas (fin_op) — esqueleto en v1

• La acuñación de una clave hija debitará más tarde el TokenTime del grupo (gratis por ahora)

• Más canales del producto a través del mismo MCP a medida que lleguen al administrador

Inicio rápido

chmod +x install.sh
./install.sh

Obtén una clave de @aiworkersbot. El MCP puede compartir esta URL — no hay token en el enlace:

https://t.me/aiworkersbot?start=mcp

La Mini App muestra el token una vez. Cópialo, luego:

aiworkers-mcp login

Pega el token en el aviso. Se escribe en ~/.config/aiworkers/credentials.json (chmod 600). Reinicia el agente. Pídele que llame a aiworkers_whoami.

La herramienta aiworkers_login_link devuelve la misma URL sin necesidad de una clave existente.

Las claves de formato heredado aún funcionan como AIWORKERS_API_KEY.

uvx sin instalar:

uvx --from git+https://github.com/dimaneuron/aiworkers-mcp.git aiworkers-mcp

Entorno

Prefiere aiworkers-mcp login a poner secretos en mcp.json. Las claves hijas por módulo no pueden llamar a otros módulos.

Alternativas (nombres antiguos aún funcionan): SURVEY_MCP_API_KEY, TASKS_MCP_API_KEY, TASKS_GROUP_ID, BOOKING_INTERNAL_SECRET.

Herramientas

Siempre activas:

• aiworkers_whoami — qué puede ver esta clave (llámala primero)

• aiworkers_login_link — URL de Telegram, sin token en el enlace

• aiworkers_skill — SKILL.md del agente

• aiworkers_skill_update — escribe/actualiza ~/.cursor/skills/aiworkers/SKILL.md

• aiworkers_token_mint — el padre awp_ acuña una hija awm_ para un módulo + grupo (se muestra una vez; save=true escribe credentials.json). Gratis por ahora; más tarde TokenTime de grupo.

surveys: survey_agent_skill, survey_get_dsl_rules, survey_validate_dsl, survey_create, survey_agent_list_forms, survey_agent_get, survey_agent_update, survey_agent_responses, survey_agent_stats, survey_agent_settings_get, survey_agent_settings_save, survey_agent_scenarios_get, survey_agent_scenarios_save, survey_agent_archive, survey_agent_delete, survey_agent_share. Recurso: survey://dsl/spec.

tasks: tasks_list, tasks_count, tasks_get, tasks_create, tasks_update, tasks_batch_update, tasks_complete, tasks_cancel.

workers (lectura + escritura, sin registros): workers_list, workers_get, workers_balance, workers_topup_link, salario/tt cotización→confirmación, workers_partner, workers_update (no para tt), memoria/chats/respuestapreparada, workers_chat_send (solo chats conocidos, bot/embed/topic), workers_broadcast_quote / workers_broadcast_confirm. Dinero y difusión: cotización luego confirm=true.

telegram (sin envío de chat): telegram_status, telegram_commands_get, telegram_commands_save, telegram_restart. Reinicia el proceso del trabajador (aibot-<username>, igual que /telegram_bot). 60s de enfriamiento por bot; 429 retry_after — no insistas. No uses workers_update para eso. Personal/difusión está en workers.

crm (CRM de reservas): crm_context, crm_process.

finance — no en v1.

Configuración del agente

Pega el mismo bloque mcpServers.aiworkers. Cambia solo la ruta del archivo de configuración.

JSON compartido:

{
  "mcpServers": {
    "aiworkers": {
      "command": "aiworkers-mcp",
      "env": {
        "AIWORKERS_API_BASE": "https://ai.knopka.click",
        "AIWORKERS_API_KEY": "PASTE_awp_OR_awm_TOKEN"
      }
    }
  }
}

Reinicia el agente después de editar.

Variante uvx (sin instalación global): consulta examples/openclaw-uvx.json.

Compatibilidad

CLI antiguas aún funcionan:

• aiworkers-survey-mcp — igual que AIWORKERS_MODULES=surveys

• aiworkers-tasks-mcp — igual que AIWORKERS_MODULES=tasks

Si el paquete general está en PYTHONPATH, delegan aquí. De lo contrario, ejecutan su FastMCP independiente como antes.

Privacidad

Este repositorio es el cliente. No pongas .env, tokens o credenciales aquí.