Conecta Stackportfolio a tu agente de código

Claude Code

Añade el servidor directamente. Obtienes las herramientas sin habilidades.

1. Agrega el servidor a tu cliente. En Claude Code:

   claude mcp add --transport http stackportfolio https://stackportfol.io/mcp

2. Ejecuta /mcp, elige stackportfolio e inicia sesión. Se abre el navegador: aprueba los permisos en la página de consentimiento.

Otros clientes

Claude.ai y Claude Desktop

Abre Ajustes, luego Conectores, elige Añadir conector personalizado y pega la dirección del servidor de arriba.

Cursor

Añade esto a .cursor/mcp.json en tu proyecto, o a ~/.cursor/mcp.json para todos los proyectos, y luego inicia sesión desde los ajustes MCP de Cursor:

{
  "mcpServers": {
    "stackportfolio": {
      "url": "https://stackportfol.io/mcp"
    }
  }
}

Codex CLI

Registra el servidor y luego inicia sesión:

codex mcp add stackportfolio --url https://stackportfol.io/mcp
codex mcp login stackportfolio

O añádelo a ~/.codex/config.toml:

[mcp_servers.stackportfolio]
url = "https://stackportfol.io/mcp"

Cualquier otro

Cualquier cliente con HTTP en streaming y OAuth solo necesita la dirección del servidor de arriba.

Subir imágenes

Los agentes pueden subir capturas sin base64. Pídele al agente que llame a create_project_media_upload con el proyecto, un nombre de archivo y un tipo de contenido (PNG, JPEG o WebP). El agente recibe una URL de subida firmada y envía el archivo con:

curl -T shot.png -H "Content-Type: image/png" "<uploadUrl>"

La URL sirve una sola vez y caduca a los 10 minutos, así que no necesitas una clave de API. Una URL ya usada se rechaza con 409, una caducada con 410 y un archivo por encima del límite de tamaño con 413. Si una subida falla después de la comprobación, pídele al agente una URL nueva.

Inicio de sesión y acceso

El cliente se registra solo y te pide aprobar permisos. Las habilidades son propias de Claude Code; otros clientes solo reciben las herramientas.

El uso de las herramientas cuenta para los mismos límites de uso que las solicitudes a la API. Desconectar la aplicación en la página de tus aplicaciones conectadas revoca su acceso de inmediato.

Solución de problemas

• Un error de permisos significa que el cliente tiene menos permisos de los que necesita la herramienta: ejecuta /mcp y vuelve a autorizar.
• Si el cliente nunca abre el navegador, ejecuta /mcp y elige stackportfolio, o elimina el servidor y vuelve a añadirlo.