Ir a la documentación
DocumentaciónInicio rápido

Conecta tu primer agente

Regístrate, guarda una clave de servicio, conecta tu agente por MCP, haz su primera llamada y responde a su primera aprobación.

En esta página

1. Crea tu cuenta

Abre my.sallyport.cloud. Pulsa «Continuar con Google», o regístrate con correo: pulsa «Continuar con correo», escribe tu correo y pulsa «Continuar». Para un correo nuevo, rellena «Nombre», «Apellidos» y «Contraseña» y pulsa «Crear cuenta». Después introduce el código de 6 dígitos del mensaje y pulsa «Confirmar correo».

Quien se registra es el propietario de la organización y de su primer espacio de trabajo. Añadir claves y agentes requiere el rol de propietario o de administrador.

2. Guarda una clave de servicio

Abre Añadir una clave. Esta guía usa GitHub: escríbelo en «Servicio del catálogo» y elige GitHub API. Deja «Producción» en «Entorno».

En «Cómo conectar GitHub API», elige «Token de acceso». Pulsa «Crear la clave en GitHub API», crea un token en GitHub y pégalo. Pulsa «Guardar la clave».

Sallyport comprueba el token con GitHub al guardarlo. Desde ese momento, todos los agentes del espacio de trabajo pueden usar la clave. La otra vía, «Iniciar sesión con GitHub», te lleva a GitHub para aprobar; el formulario indica lo que necesita.

3. Crea un agente

Abre Agentes y pulsa «Nuevo agente». Escribe un «Nombre», como laptop-claude, y pulsa «Crear agente». Se abre la página del agente.

Su lista «Acceso» ya incluye la clave de GitHub. Las filas nuevas ejecutan cada llamada sin preguntar.

4. Conecta Claude Code

En la página del agente, «Conectar este agente» tiene Claude Code seleccionado. Pulsa «Copiar para Claude Code». Sallyport crea un token y copia el comando completo con él.

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"

Ejecútalo en una terminal y reinicia Claude Code. El comando copiado lleva el token dentro; el ejemplo de arriba lo lee de SP_AGENT_TOKEN. Una vez añadido, claude mcp list muestra sallyport.

El token se muestra una sola vez y aparece en «Tokens» en la página del agente. Para Cursor, Codex, Claude, ChatGPT y otros clientes, consulta Clientes MCP y servidores remotos.

5. Haz la primera llamada

Pide al agente: «Lee mi perfil de GitHub a través de Sallyport». Encuentra GitHub entre sus herramientas y llama a github_read con estos argumentos:

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

Sallyport añade el token, llama a api.github.com y devuelve la respuesta de GitHub. El agente nunca ve el token. La llamada y su resultado aparecen en Actividad.

6. Responde a tu primera aprobación

Las llamadas se ejecutan sin preguntar hasta que decidas otra cosa. En la página del agente, en la lista «Acceso», activa «Preguntar en cada llamada» en la fila de GitHub.

Pide al agente que vuelva a leer el perfil. La llamada espera, y su tarjeta aparece en Aprobaciones y en cualquier página abierta de la consola. Si la espera se alarga, el agente te muestra el enlace de la tarjeta.

Pulsa «Aprobar»: la llamada se ejecuta y el agente recibe la respuesta. «Rechazar» la detiene, y el agente lee el motivo que escribas. Las tarjetas también pueden llegar a este navegador, a Telegram o al correo: actívalo en Notificaciones. Más en Aprobaciones.

Sin clave, el agente la pide

Un agente puede llegar a un servicio público que no has conectado. Llama a http_request con la URL completa, o a request_access con el nombre del servicio y un purpose: una frase sobre para qué lo necesita. Sallyport responde con un enlace para ti.

JSON · argumentos de http_request
{
  "method": "GET",
  "url": "https://api.stripe.com/v1/balance"
}

El enlace abre la solicitud en Falta una clave. Añade la clave o inicia sesión y pulsa «Conceder acceso». Todos los agentes del espacio de trabajo reciben la clave, y el agente repite su llamada.