> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stockshift.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Servidor MCP

> Conecta un asistente de IA a StockShift para que consulte información y haga trabajo en nombre de un miembro.

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](https://docs.stockshift.io/es/guides/oauth-apps.md). 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](https://docs.stockshift.io/es/api-reference/introduction.md), 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](https://docs.stockshift.io/es/guides/rate-limits.md).


## Related topics

- [Llama al servidor MCP](https://docs.stockshift.io/es/api-reference/servidor-mcp/llama-al-servidor-mcp.md)
- [StockShift para desarrolladores](https://docs.stockshift.io/es/index.md)
- [Límites de solicitudes](https://docs.stockshift.io/es/guides/rate-limits.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.