Saltar al contenido principal
StockShift es un servidor MCP, así que un asistente de IA como Claude o ChatGPT puede consultar información y hacer trabajo en StockShift. El asistente trabaja como el miembro que lo conectó: solo puede hacer lo que ese miembro puede hacer, y solo lo que le permite. Cada cambio que hace queda en el historial de auditoría con el nombre del miembro y el nombre de la app. El servidor está en https://app.stockshift.io/mcp y usa Streamable HTTP. Necesita el plan Starter o uno superior.

​
Conecta un asistente

  1. En tu asistente, agrega un conector personalizado o un servidor MCP con la dirección de arriba.
  2. El asistente abre StockShift en tu navegador y te pide iniciar sesión.
  3. La página Conectar muestra el nombre de la app y a dónde volverás. Cualquiera puede registrar una app, así que continúa solo si tú iniciaste la conexión y confías en la app.
  4. Elige la organización en la que debe trabajar la app.
  5. Decide qué puede hacer, módulo por módulo.
  6. Presiona Permitir acceso.
El inicio de sesión usa el mismo flujo OAuth que cualquier app OAuth. Un cliente MCP lo encuentra a partir del encabezado WWW-Authenticate de su primera llamada sin autenticar, que apunta a /.well-known/oauth-protected-resource.

​
Herramientas

El asistente recibe una herramienta por cada acción que StockShift puso a disposición de las automatizaciones, como buscar un artículo, crear una orden de compra o confirmar un pedido de venta. Una herramienta solo aparece si los permisos del miembro, el plan y los alcances que permitió le dejan usarla. Llama a tools/list para verlas. Llamar al servidor MCP, en la referencia de la API, muestra todas las herramientas que tiene el servidor. Las herramientas que solo consultan se marcan como de solo lectura, y las que cambian algo se marcan como de cambio. Cada herramienta recibe los mismos campos que el endpoint REST correspondiente.
  • Una llamada que no es válida, o que el miembro no puede hacer, vuelve como un error de herramienta con los mismos detalles del problema que envía la API REST.
  • Enviar la misma llamada dos veces hace el cambio una sola vez. Una llamada puede indicar su propia clave en _meta.idempotencyKey. Sin una, el id de la propia solicitud funciona como clave.
  • Una respuesta se corta en 100 KB con una nota que indica usar el endpoint REST para obtener más.
  • Cada app está limitada a 30 llamadas a herramientas por minuto, además de los límites de solicitudes.