Pipedrive MCP: consultar y cambiar el CRM según el nivel de seguridad

Para quién

Si quieres consultar, crear o actualizar datos CRM de Pipedrive directamente en Claude Code o Claude Desktop, este servicio encaja. Es un servidor MCP para uso local o autoalojado, autenticado con una clave API de Pipedrive.

Para quien ya tiene una cuenta Pipedrive y una clave API, y cuyo cliente puede ejecutar MCP STDIO. El texto oficial indica que el transporte actual es solo STDIO, sin OAuth alojado. Si necesitas acceso HTTP remoto o inicio de sesión OAuth, esta página no tiene una ruta usable.

El nombre de paquete debe ser el @ckalima/pipedrive-mcp-server con ámbito. El texto oficial es explícito: si un fragmento antiguo cita el pipedrive-mcp-server sin ámbito, ese es otro paquete sin relación; no lo instales por error.

Primera prueba en 3 minutos

La ruta oficial recomendada es la instalación guiada. Requisitos previos: tener lista una clave API de Pipedrive, elegir Claude Code o Claude Desktop, y el transporte solo STDIO.

En un terminal ejecuta:

npx -y @ckalima/pipedrive-mcp-server init

Sigue la guía para escribir el servidor en la configuración del cliente. Si debes editar la configuración a mano, el comando es npx, los argumentos son -y y @ckalima/pipedrive-mcp-server, y define PIPEDRIVE_API_KEY en el entorno. No escribas ninguna cadena de clave de ejemplo ni uses el nombre de paquete sin ámbito.

En la primera prueba pon PIPEDRIVE_MODE en read-only. El texto oficial define este nivel como solo lectura; el nivel predeterminado safe-write ya incluye escrituras no destructivas y no encaja en la primera vez.

Luego haz una llamada de bajo riesgo: consultar datos CRM. El texto oficial dice que puedes Query, create, and update CRM data desde el asistente; la primera prueba solo hace Query. El texto oficial no da un nombre de herramienta concreto ni un tipo de objeto. Usa solo herramientas de consulta que el cliente liste para este servidor. No inventes nombres de herramientas que no aparecen, ni crees ni actualices registros.

Señal de éxito: vuelve un resultado de consulta de registros ya existentes en Pipedrive, sin escritura. Si en el nivel actual no se ven herramientas de escritura, encaja con el texto oficial: las herramientas fuera del nivel se ocultan y una llamada directa se rechaza.

Casos de uso

Caso 1: consulta CRM de solo lectura. Pon PIPEDRIVE_MODE en read-only y consulta datos existentes. El texto oficial solo llega a Query CRM data, sin objetos, filtros ni paginación. En caso de éxito deberías ver registros existentes; no trates una consulta como una exportación completa.

Caso 2: crear o actualizar registros en el nivel predeterminado safe-write. El texto oficial dice que el nivel predeterminado es lectura más escrituras no destructivas, equivalente a create y update. Esto cambia el CRM; antes de la llamada, confirma qué dato de negocio vas a cambiar. El texto oficial no da lista de campos ni carga de ejemplo. Usa solo la capacidad de crear o actualizar que muestre el cliente, y reformula el contenido a escribir antes de ejecutar. Deletes, conversions y otras irreversible writes no están en este nivel; el texto oficial exige el nivel full para abrirlas.

Límites de uso

PIPEDRIVE_MODE tiene read-only, safe-write (predeterminado) y full. Las herramientas fuera del nivel no aparecen en la lista de herramientas y una llamada directa se rechaza. Deletes, conversions y otras irreversible writes necesitan full; no abras ese nivel en la primera prueba.

El transporte es por ahora solo STDIO; Streamable HTTP es solo una marca planificada y no puede tratarse como ya ofrecida en esta página. La autenticación es una clave API de Pipedrive, sin OAuth alojado. La clave vive en una variable de entorno local; consultas y escrituras salen a la red hacia Pipedrive.

El texto oficial no escribe límites de ritmo ni revocación. Si una escritura tiene éxito, debes revertirla tú en Pipedrive. Usar el nombre de paquete sin ámbito pipedrive-mcp-server es, según el texto oficial, otro paquete sin relación.