Conectar Claude Desktop a Dureach mediante MCP significa registrar un cliente OAuth, completar el consentimiento del espacio de trabajo, añadir el servidor HTTP transmitible y ejecutar una primera búsqueda acotada. Calcule unos 20 minutos más el tiempo de aprobación para ámbitos de escritura.
¿Qué debe preparar antes de abrir Claude Desktop?
Seleccione el espacio de trabajo, confirme la capacidad de plataforma de agentes y defina la tarea: el acceso de solo investigación necesita workspace:read, companies:read y trade:read; la consulta de contactos añade contacts:read. Mantenga leads:create, campaigns:create y los ámbitos de envío fuera de la primera concesión. Nombre a un propietario que revisará los datos candidatos antes de que cambien registros autoritativos.
¿Cómo se registra y autoriza el cliente?
- Registre un cliente OAuth para el espacio de trabajo con los ámbitos elegidos.
- Inicie la concesión de autorización y complete el consentimiento en el navegador como miembro del espacio de trabajo.
- Guarde las credenciales en el almacén protegido del cliente o en un gestor de secretos del servidor. Nunca pegue un token en una conversación, documento compartido, captura o ticket.
- Confirme que la audiencia del token es el recurso
/mcpy que el ID del espacio de trabajo coincide con el espacio de trabajo previsto.
Las tablas completas de campos están en Conectar un cliente de IA mediante MCP.
¿Cómo se añade el servidor en Claude Desktop?
- Añada un servidor MCP HTTP transmitible con la URL
https://app.dureach.com/mcp. - Seleccione autenticación OAuth e indique los valores de registro del cliente; utilice la URL de metadatos del recurso MCP cuando el conector pida detección.
- Complete el consentimiento y confirme que la lista de herramientas incluye
dureach.workspace.context,dureach.workspace.capabilitiesy las herramientas de lectura concedidas. - Llame primero a
dureach.workspace.contexty compruebe el ID del espacio de trabajo, el rol y los ámbitos devueltos.
¿Cómo se ejecuta una primera búsqueda acotada?
Use tools/list para descubrir las herramientas disponibles para su conexión. La disponibilidad depende de los permisos concedidos y del acceso del espacio de trabajo. Empiece con permisos de lectura; pida a un administrador que revise el acceso que falta en lugar de solicitar permisos amplios.
¿Qué comprobaciones cierran la configuración?
Revise los permisos, los cambios de política y los registros de actividad disponibles antes de ampliar el acceso. Guarde solo ID de solicitudes sin datos sensibles y metadatos operativos en notas compartidas. Retire la conexión al terminar el proyecto o cuando ya no sea necesaria; revoque y sustituya cualquier credencial que pueda haberse filtrado.
¿Cuáles son preguntas habituales sobre la configuración de Claude Desktop?
¿Cuánto tarda la configuración?
El registro y el consentimiento toman minutos; reserve tiempo adicional cuando los ámbitos de escritura necesiten revisión del propietario.
¿Por qué la lista de herramientas está vacía?
Use tools/list para descubrir las herramientas disponibles para su conexión. La disponibilidad depende de los permisos concedidos y del acceso del espacio de trabajo. Empiece con permisos de lectura; pida a un administrador que revise el acceso que falta en lugar de solicitar permisos amplios.
¿Puede un conector servir a dos espacios de trabajo?
No. Los tokens están vinculados al espacio de trabajo del consentimiento. Registre y autorice por separado por espacio de trabajo.
¿Debe el conector recibir ámbitos de envío el primer día?
No. Añada envíos solo tras completar el comportamiento de lectura, las simulaciones y la revisión de la política vigente.
¿Qué demuestra que la configuración funcionó?
workspace.context devuelve el espacio de trabajo esperado, capabilities lista las herramientas esperadas y una búsqueda acotada devuelve filas revisables.
¿Dónde van las llamadas fallidas para revisión?
Conserve el request_id, la marca temporal, el nombre de la herramienta y el código de error; nunca conserve el token junto a filas de resultados en notas compartidas.