URL del servidor, transporte y flujo OAuth para Cursor, MCP Inspector y otros clientes MCP, con todas las direcciones de descubrimiento para desarrolladores.
Además de Claude y ChatGPT, funciona cualquier cliente MCP que admita servidores remotos por HTTP e inicio de sesión con OAuth, por ejemplo IDE como Cursor o el MCP Inspector para pruebas. Este artículo es para quien configura un cliente así por su cuenta o crea su propia integración.
Datos clave
- URL del servidor
- https://dock.at-harbor.com/mcp
- Transporte
- Streamable HTTP, sin estado. Cada petición es un POST con un mensaje JSON-RPC (o un lote), y la respuesta llega como JSON. No hay ID de sesión ni stream del servidor.
- Versiones del protocolo
- 2025-11-25, 2025-06-18 y 2025-03-26
- Métodos
- initialize, ping, tools/list y tools/call. El servidor no ofrece resources ni prompts.
- Inicio de sesión
- OAuth 2.1 con PKCE (S256). Sin token, el servidor responde con 401 y remite a sus metadatos en el encabezado WWW-Authenticate.
Configurar un cliente
- En tu cliente, añade un servidor MCP remoto (a menudo llamado «Remote», «HTTP» o «Streamable HTTP»)
- Introduce https://dock.at-harbor.com/mcp como URL
- Deja vacíos el client ID y el secret: el cliente se registra solo
- Inicia la conexión; el inicio de sesión se abre en tu navegador, seguido de la página de consentimiento de LinkHarbor
- Elige el espacio de trabajo y los permisos y haz clic en «Permitir»
Cómo se llama el ajuste varía de un programa a otro. En el MCP Inspector, por ejemplo, eliges el transporte «Streamable HTTP».
El flujo OAuth en detalle
- El cliente llama al servidor MCP sin token y recibe 401 con una referencia a los metadatos del recurso
- Lee los metadatos del servidor de autorización (endpoints, métodos admitidos, permisos)
- Se registra: mediante Dynamic Client Registration o con un documento de metadatos del cliente en una URL https
- Abre el navegador con la solicitud de autorización, incluidos PKCE y resource=https://dock.at-harbor.com/mcp
- Inicias sesión y decides en la página de consentimiento
- El cliente canjea el código por un access token y un refresh token
| Paso | Validez |
|---|---|
| Solicitud de inicio de sesión hasta tu decisión | 10 minutos |
| Código de autorización | 60 segundos, un solo uso |
| Access token | 1 hora |
| Refresh token | Se renueva con cada uso; caduca tras 90 días sin uso |
Si un cliente no solicita ningún permiso, se solicitan todos; aun así puedes acotarlos en la página de consentimiento. Si se vuelve a usar un refresh token que ya se había sustituido, LinkHarbor cierra toda la conexión por seguridad.
Reglas para las direcciones de redirección
- Direcciones https
- http solo para direcciones loopback en tu propio ordenador (para clientes de escritorio e IDE)
- Esquemas propios de app en notación de dominio inversa
- Como máximo 10 direcciones por cliente, sin fragmentos
Si una app envía una dirección que no está registrada para ella, LinkHarbor se detiene: «La app envió una dirección de retorno que no está registrada para ella. Se detuvo la solicitud.»
Direcciones de descubrimiento para desarrolladores
| Documento | Dirección |
|---|---|
| Metadatos del recurso (RFC 9728) | https://dock.at-harbor.com/.well-known/oauth-protected-resource/mcp |
| Servidor de autorización (RFC 8414) | https://dock.at-harbor.com/.well-known/oauth-authorization-server |
| Revocación de tokens (RFC 7009) | https://dock.at-harbor.com/oauth/revoke |
| MCP Server Card | https://dock.at-harbor.com/.well-known/mcp/server-card.json |
| Instrucciones para agentes | https://dock.at-harbor.com/auth.md |
Apps desconocidas
Las apps cuyas direcciones de redirección están todas en claude.ai, claude.com, chatgpt.com u openai.com se consideran conocidas. Los programas de tu propio ordenador que vuelven a través de localhost, como Claude Code, Codex o los IDE, muestran en la página de consentimiento el aviso «LinkHarbor no conoce esta app. Se ejecuta en tu propio ordenador. Continúa solo si acabas de iniciarla tú» y, abajo, «Después de elegir volverás a la app en tu ordenador». Las demás apps web desconocidas muestran «LinkHarbor no conoce esta app. Continúa solo si lo iniciaste tú y confías en …», con su dirección en lugar de los puntos suspensivos. Ambos avisos son normales si acabas de configurar el cliente tú mismo. Solo aparece un logotipo si la app lo envía. Si no iniciaste tú el inicio de sesión, haz clic en «Rechazar».
También te puede ser útil
¿No has encontrado nada?
Cuéntanos qué necesitas y nuestro equipo de soporte te ayudará personalmente.