Ir a la documentación
DocumentaciónMCP

Clientes MCP y servidores remotos

Conecta Claude Code, Cursor, Codex, Claude, ChatGPT y otros clientes MCP a Sallyport, y da a tus agentes servidores MCP remotos.

En esta página

La dirección

Todo cliente MCP se conecta a https://mcp.sallyport.cloud/mcp por Streamable HTTP. Funcionan los clientes de la revisión 2026-07-28 de MCP y los de revisiones anteriores.

La mayoría de los clientes se conectan iniciando sesión: añades la dirección, entras en Sallyport en el navegador y pulsas «Permitir». Sin token que copiar y sin preparar nada antes en la consola. Los scripts y los clientes sin inicio de sesión envían en su lugar un token de agente en la cabecera Authorization: Bearer.

Conecta iniciando sesión

Así se conectan Claude, Claude Code, ChatGPT, Codex, Cursor, VS Code, Gemini CLI y MCP Inspector. La página de cada cliente en Integraciones muestra dónde va la dirección.

  • Añade https://mcp.sallyport.cloud/mcp como servidor MCP en tu cliente.
  • El cliente se registra por su cuenta en Sallyport y lo abre en tu navegador.
  • Inicia sesión o crea una cuenta. La conexión te espera 30 minutos, tiempo de sobra para confirmar tu correo.
  • Lee la pantalla de consentimiento, «Permitir que … conecte un agente», y pulsa «Permitir». El navegador vuelve al cliente, y el cliente queda conectado.

La pantalla de consentimiento

«Quién lo pide» nombra al cliente. Un cliente conocido por su propio sitio web muestra «Dominio verificado» con ese dominio, y «Publicado por Anthropic» para claude.ai o «Publicado por OpenAI» para chatgpt.com. Un cliente que se registró solo muestra «Sin verificar» y «Este cliente se registró por su cuenta. Sallyport no pudo comprobar su nombre.»

«Adónde vas después» dice adónde llega tu navegador tras «Permitir»: un sitio web, una app o «Después de permitirlo, vuelves a una app de este ordenador». Este último caso trae un aviso: «Permítelo solo si acabas de iniciar esta conexión desde una app de este ordenador.» Si el enlace te lo envió otra persona, pulsa «Rechazar».

«Qué puede usar el agente» muestra cada servicio con «Se ejecuta directamente» o «Te pregunta antes». El agente nuevo de un miembro muestra «Nada todavía. Un administrador le da servicios a este agente en la consola.»

«Detalles» guarda el client ID, la dirección de redirección y, si hay más de un espacio de trabajo, el espacio al que se une el agente.

Qué hace «Permitir»

Sallyport crea un agente con el nombre del cliente. El agente de un propietario o administrador recibe todos los servicios del espacio de trabajo. El de un miembro empieza sin ninguno hasta que un administrador se los añade en «Acceso», en la página del agente.

La primera vez que alguien conecta un cliente, cada propietario recibe una notificación con un enlace que lo desconecta. El registro guarda cada consentimiento.

Un cliente vuelve a iniciar sesión desde una sesión nueva, un puerto nuevo o cuando renueva su acceso. Mientras el agente esté activo, verás una pantalla corta «Reconectar Claude Code» con un solo botón «Reconectar». El cliente no recibe nada hasta que lo pulses. Los propietarios no reciben otro aviso. Si el agente se pausó, la pantalla de consentimiento completa vuelve a preguntar. Si se eliminó, volver a iniciar sesión es una conexión nueva y cada propietario recibe un aviso.

Apps conectadas

Configuración, Apps conectadas muestra cada cliente de IA que inició sesión. Los miembros ven y desconectan los suyos. Propietarios y administradores ven y desconectan los de todos.

«Desconectar» corta el acceso del cliente: «Sus llamadas se detienen al instante en todos los ordenadores desde los que inició sesión. Para volver a usarlo, inicia sesión desde la app y permítelo.»

Plataformas con un agente por máquina

Una plataforma que ejecuta agentes en máquinas propias, como detachbox, se conecta una vez. Su pantalla de consentimiento es una tarjeta corta: quién pide, adónde vuelve usted y tres líneas. detachbox podrá crear un agente para cada una de sus máquinas, ver sus agentes y ponerlos en chats. Solo podrá renombrar, pausar o eliminar los agentes que creó. Cada agente nuevo empieza sin acceso, y usted elige qué puede usar cada uno. La conexión en sí no es un agente y no usa ningún servicio, por eso la tarjeta no lista ninguno.

Cada máquina tiene su propio agente, así Actividad y las aprobaciones muestran qué máquina llamó. El agente de una máquina nueva no puede usar nada. detachbox le lleva a su página, usted elige sus servicios o copia el acceso de otro agente, y «Listo» le devuelve. Aplicaciones conectadas muestra cuántos agentes gestiona la app, cada uno con su máquina. Pausar un agente detiene una máquina. «Desconectar» las detiene todas, y vuelven con su acceso al conectar de nuevo. Todas las máquinas de una conexión cuentan como un agente en cualquier plan.

Consigue un token de agente

Un token sirve para un script, un archivo de proyecto compartido en git o un cliente sin inicio de sesión. Abre el agente en Agentes. «Conectar este agente» copia una configuración lista para Claude Code, Cursor o un archivo .mcp.json de proyecto. Lleva el token que acabas de crear con «Nuevo token», o uno nuevo.

Para otro cliente, pulsa «Nuevo token» en «Tokens» y cópialo: solo se muestra una vez. El token identifica al agente y su acceso. No contiene ninguna clave de servicio.

El botón de la papelera junto a un token lo revoca. «Direcciones IP permitidas (opcional)», en «Límites», restringe desde dónde funcionan los tokens del agente.

Claude Code con token

Pulsa «Copiar para Claude Code» y ejecuta el comando en una terminal. --scope user añade Sallyport a todos los proyectos. Compruébalo con claude mcp list y reinicia Claude Code.

Shell · el mismo comando, escrito a mano
export SP_AGENT_TOKEN='<agent-token>'
claude mcp add --transport http --scope user sallyport https://mcp.sallyport.cloud/mcp --header "Authorization: Bearer $SP_AGENT_TOKEN"

«Pegar en Claude» da un mensaje en su lugar. Pulsa «Copiar mensaje para Claude», pégalo en un chat de Claude Code, y Claude ejecuta el comando él mismo.

«Etiquetar cada sesión de Claude Code» es opcional. Pulsa «Copiar hook de sesión para Claude» y pégalo en Claude Code. Así cada llamada muestra la sesión y la carpeta de las que vino.

Cursor y el .mcp.json de un proyecto

«Copiar para Cursor» da esto para ~/.cursor/mcp.json, con el token ya puesto:

JSON · ~/.cursor/mcp.json
{
  "mcpServers": {
    "sallyport": {
      "url": "https://mcp.sallyport.cloud/mcp",
      "headers": {
        "Authorization": "Bearer <agent-token>"
      }
    }
  }
}

«Copiar .mcp.json» da lo mismo con "type": "http", para el .mcp.json de un proyecto en Claude Code. Ese archivo lleva el token, así que déjalo fuera de git.

Codex CLI, Gemini CLI y VS Code con token

Estos clientes se configuran a mano con la misma dirección y el mismo token.

TOML · ~/.codex/config.toml
[mcp_servers.sallyport]
url = "https://mcp.sallyport.cloud/mcp"
bearer_token_env_var = "SP_AGENT_TOKEN"
tool_timeout_sec = 300

Codex lee el token de SP_AGENT_TOKEN en el entorno desde el que se inicia. Sallyport mantiene abierta una llamada que espera aprobación como mucho 240 segundos. Con tool_timeout_sec = 300, Codex espera ese tiempo; por defecto espera 60 segundos.

JSON · ~/.gemini/settings.json
{
  "mcpServers": {
    "sallyport": {
      "httpUrl": "https://mcp.sallyport.cloud/mcp",
      "headers": {
        "Authorization": "Bearer <agent-token>"
      }
    }
  }
}
JSON · mcp.json de usuario en VS Code
{
  "servers": {
    "sallyport": {
      "type": "http",
      "url": "https://mcp.sallyport.cloud/mcp",
      "headers": {
        "Authorization": "Bearer <agent-token>"
      }
    }
  }
}

Gemini CLI recibe la dirección en httpUrl. VS Code abre su archivo con «MCP: Open User Configuration». Sustituye <agent-token> y deja estos archivos fuera de los repositorios.

Qué ve el agente

Cada servicio llega como herramientas con su nombre. Un servicio HTTP tiene dos: github_read solo acepta lecturas, y github_write acepta cualquier llamada. Ambas reciben method y la ruta completa path de la documentación de la API del servicio:

JSON · argumentos de github_read
{
  "method": "GET",
  "path": "/user"
}

Una base de datos recibe las herramientas _query y _execute, y un host SSH recibe _exec para comandos y _sftp_read y _sftp_write para sus archivos. Un buzón recibe _read, _send y _change. Las herramientas de un servidor MCP remoto conservan su nombre detrás del nombre de la conexión. Todo agente tiene además las herramientas integradas:

HerramientaQué hace
list_accessTodos los servicios a los que llega el agente: sus herramientas, qué se ejecuta directamente, qué espera a una persona y si su clave funciona.
http_requestLlama a cualquier URL HTTPS pública. Un host sin clave se convierte en una solicitud de acceso con un enlace para ti.
request_accessPide un servicio por host o por nombre, con un purpose para la persona que concede el acceso.
get_callEl estado de una llamada, también de una que espera aprobación.
list_requestsLas solicitudes de acceso del agente: abiertas, concedidas o rechazadas con un motivo.
cancel_requestRetira una solicitud de acceso, o una llamada propia del agente que espera a una persona.
ssh_execEjecuta un comando en un host SSH por su nombre de host. Aparece cuando el agente tiene un host SSH; un host fuera de su lista se convierte en una solicitud de acceso con un enlace para ti.
fetch_bodyEl resto de una respuesta larga.
feedbackUna nota al equipo de Sallyport sobre lo que estorbó al agente.
search_tools, callAparecen cuando la lista pasa de 40 herramientas: buscan una herramienta de un servidor MCP remoto y la ejecutan.

Una llamada que espera a una persona se lo dice al cliente al instante, si el cliente envió un progressToken. Esa notificación de progreso, y cada una posterior de la llamada, lleva _meta con sallyport.cloud/call_id y sallyport.cloud/approve_url. El enlace de aprobación también va en el texto del mensaje, así cualquier cliente puede mostrarlo.

Conecta un servidor MCP remoto

Abre MCP remoto. Introduce la «URL del servidor MCP»: la dirección HTTPS completa, con el puerto si no es el estándar y con su ruta, como https://mcp.example.com/mcp.

Elige la «Autenticación»: «Sin autenticación», «Token Bearer», «Basic», «Clave API» en una cabecera o un parámetro de consulta, u «OAuth 2.1». Pulsa «Guardar clave y conectar».

Todos los agentes del espacio de trabajo reciben las herramientas del servidor. Sallyport se conecta al servidor, añade su clave y devuelve los resultados. El agente sigue conectado solo a https://mcp.sallyport.cloud/mcp.

Inicia sesión en un servidor con OAuth 2.1

Con «OAuth 2.1», al guardar se abre la página de inicio de sesión del servidor y luego vuelves a la conexión. Sallyport guarda los tokens y los renueva.

Sallyport se registra por sí mismo en los servidores que lo permiten. Para cualquier otro, registra una aplicación con la URI de redirección https://mcp.sallyport.cloud/callback/upstream. Introduce su ID en «Client ID de la aplicación (opcional)», y su secreto si lo tiene.

Cuando el acceso caduque, pulsa «Volver a conectar con OAuth» en la página de la conexión.