¿Qué hace crm-agent-plugin?

Plugin de agente CRM seguro con habilidades Codex, integración remota de MCP y autenticación WeCom.

Descripción

Este plugin permite que asistentes de IA como Claude Code o Codex ejecuten operaciones CRM de forma segura. Incluye habilidades predefinidas para acciones comunes de CRM, como crear, leer, actualizar y eliminar registros, además de listar contactos y generar informes.

Características

Habilidades Codex: Comandos integrados para gestionar contactos, oportunidades y cuentas.
Integración remota de MCP: Conexión segura con servidores MCP remotos para acceder a datos CRM en la nube.
Autenticación WeCom: Verificación de identidad a través de WeChat Work para control de acceso.
Seguridad: Comunicaciones cifradas y manejo seguro de tokens.

Requisitos previos

Python 3.10 o superior
Acceso a una instancia de Claude Code o Codex con soporte de plugins
Credenciales de WeCom (AppKey y AppSecret)
URL del servidor MCP remoto (opcional si se usa integración MCP)

Instalación

pip install crm-agent-plugin

O clona el repositorio:

git clone https://github.com/ifczt/crm-agent-plugin.git
cd crm-agent-plugin
pip install -r requirements.txt

Configuración

Configura las variables de entorno:

export CRM_API_URL="https://api.tucrm.com/v1"
export CRM_API_KEY="tu_api_key"
export WECOM_APP_KEY="tu_wecom_app_key"
export WECOM_APP_SECRET="tu_wecom_app_secret"

Si usas MCP remoto:

export MCP_REMOTE_URL="https://mcp.tuservidor.com"
export MCP_REMOTE_TOKEN="tu_token_seguro"

Uso

En Claude Code / Codex

Una vez instalado y configurado, puedes usar los siguientes comandos:

/crm create-contact --name "Juan Pérez" --email "[email protected]" --phone "+123456789"
/crm list-contacts
/crm get-contact --id 123
/crm update-contact --id 123 --email "[email protected]"
/crm delete-contact --id 123

Integración MCP

El plugin se conecta automáticamente al servidor MCP remoto si está configurado. Puedes enviar consultas CRM directas:

@mcp consulta: "dame los 5 contactos principales con más ingresos"

Autenticación WeCom

El plugin verifica automáticamente la identidad del usuario mediante WeCom. Los tokens se renuevan automáticamente.

Ejemplo de SKILL.md

name: crm_agent
version: 1.0.0
description: Habilidades CRM para el agente
skills:
  - name: create_contact
    description: Crea un nuevo contacto en CRM
    parameters:
      - name: name
        type: string
        required: true
      - name: email
        type: string
        required: false
      - name: phone
        type: string
        required: false
  - name: list_contacts
    description: Lista todos los contactos
    parameters: []

API de habilidades

`create_contact(name, email, phone)`

Crea un nuevo contacto en el sistema CRM.

`list_contacts()`

Devuelve una lista de todos los contactos.

`get_contact(id)`

Obtiene los detalles de un contacto específico.

`update_contact(id, email, phone)`

Actualiza la información de un contacto existente.

`delete_contact(id)`

Elimina un contacto del sistema CRM.

Seguridad

Todas las comunicaciones con el CRM y el servidor MCP se realizan mediante HTTPS.
Los tokens de autenticación de WeCom se almacenan de forma segura y se renuevan periódicamente.
Las claves de API nunca se registran en los logs.

Licencia

MIT

Soporte

Para problemas o preguntas, abre un issue en GitHub.

ifczt/crm-agent-plugin

¿Qué es crm-agent-plugin?

Preguntar en tu IA favorita

Documentación