Guía de configuración de la integración de Zendesk MCP

Configuración del repositorio

1. Clonar el repositorio:
   git clone https://your-repo-url/mcp-experiments.git cd mcp-experiments/zd-mcp-server
2. Instalar dependencias:
   npm install
3. Configure las variables de entorno en su entorno de desarrollo:
   export ZENDESK_EMAIL="your-email@example.com" export ZENDESK_TOKEN="your-zendesk-api-token" export ZENDESK_SUBDOMAIN="your-zendesk-subdomain"

Construyendo el Proyecto

1. Construya el proyecto TypeScript:
   npm run build
   Esto compilará los archivos TypeScript en JavaScript en el directorio dist .
2. Para el desarrollo, puedes utilizar:
   npm run dev

Instalación con la aplicación de escritorio Claude

1. Actualice el archivo de configuración de Claude Desktop ( claude_desktop_config.json ):
   { "tools": { "zendesk": { "command": "node", "env": { "ZENDESK_EMAIL": "internal@z3nmail.com", "ZENDESK_TOKEN": "your-zendesk-api-token", "ZENDESK_SUBDOMAIN": "your-zendesk-subdomain" }, "args": [ "/path/to/mcp-experiments/zd-mcp-server/dist/index.js" ] } } }
2. Reemplace las variables de entorno con sus credenciales reales de Zendesk.
3. Actualice la ruta para que coincida con la ubicación de su archivo index.js creado.
4. Reinicie la aplicación Claude Desktop para que los cambios surtan efecto.

Herramientas de Zendesk disponibles

La integración de MCP Zendesk proporciona las siguientes funciones:

1. zendesk_get_ticket : recupera un ticket por ID
2. zendesk_get_ticket_details : obtiene los detalles del ticket, incluidos los comentarios
3. zendesk_search : busca tickets con la sintaxis de consulta de Zendesk
4. zendesk_create_ticket - Crea un nuevo ticket
5. zendesk_update_ticket : actualiza las propiedades del ticket
6. zendesk_add_private_note : agrega una nota interna a un ticket
7. zendesk_add_public_note : agrega un comentario público a un ticket

Configuración de autenticación

1. Genere un token de API en su Centro de administración de Zendesk:
   • Vaya al Centro de administración > Aplicaciones e integraciones > API > API de Zendesk
   • Agregue un token API y cópielo
2. Utilice su dirección de correo electrónico y el token API en su configuración de MCP

Solución de problemas

• Si encuentra errores de autorización, verifique que su token API sea válido
• Asegúrese de que su subdominio de Zendesk sea correcto
• Compruebe que las variables de entorno estén configuradas correctamente
• Reinicie el servidor MCP después de realizar cambios