# Conexiones MCP (/es/docs/developer/mcp-connections) Conecta un cliente MCP a Sift con tu cuenta personal o una clave de API de organización. Usa OAuth personal cuando el agente necesite tus permisos, vistas de aplicación o respuestas confirmadas por humanos. ## De un vistazo [#de-un-vistazo] | Configuración | Valor | | --- | --- | | URL del servidor | `https://mcp.getsift.ai/mcp` | | Transporte | Streamable HTTP | | Autenticación personal | Código de autorización OAuth con PKCE | | Autenticación de servicio | `Authorization: Bearer ` | | Duración del token de acceso | 90 días | | Token de actualización | No compatible; autentícate de nuevo | | Selección de organización | Una o todas las organizaciones al iniciar sesión; organización de la clave para claves de API | | Vistas de aplicación y confirmación de respuesta | Se requiere OAuth personal | ## Qué estás viendo [#qué-estás-viendo] Abre **Configuración → Conexiones → Acceso para desarrolladores → MCP** en Sift. Copia la URL del servidor desde tu entorno. La URL pública es una dirección de conexión, no una contraseña. Tu token OAuth o clave de API es la credencial. Mantén las credenciales fuera de mensajes, capturas de pantalla y repositorios. ## Conectar con OAuth personal [#conectar-con-oauth-personal] 1. Agrega un servidor MCP remoto en la configuración del conector de tu cliente. 2. Nombra la conexión `Sift`. 3. Establece su URL en `https://mcp.getsift.ai/mcp`. 4. Elige OAuth si el cliente lo solicita para la autenticación. 5. Completa el inicio de sesión en Sift. Selecciona una organización o **All organizations**. 6. Obtén la lista de herramientas y llama a `list_skills` con un objeto vacío. 7. Realiza una lectura autorizada pequeña antes de una tarea más grande. Usa un cliente que admita Streamable HTTP remoto y el flujo OAuth de Sift. Los nombres de clientes y los menús de conectores pueden cambiar. La pestaña MCP de Sift contiene guías de configuración para clientes. Un cliente que solo admite servidores de proceso local necesita un método de conexión remota compatible. El servidor admite registro dinámico de clientes y PKCE con `S256`. Los códigos de autorización expiran después de cinco minutos. Los tokens de acceso expiran después de 90 días. No existe un flujo de token de actualización. Si el token expira, repite el inicio de sesión. ## Usar varias organizaciones [#usar-varias-organizaciones] Si seleccionas **All organizations** al iniciar sesión, una conexión llega a todas las organizaciones de las que eres miembro. Funciona como un perfil predeterminado con una opción para cambiarlo en una llamada: | Herramienta o argumento | Qué hace | | --- | --- | | `list_orgs` | Muestra tus organizaciones y marca la activa. | | `switch_org` | Cambia la organización activa de esta conexión. | | `org` en una llamada | Ejecuta esa llamada en la organización indicada. La organización activa no cambia. | Una conexión nueva con todas las organizaciones no tiene organización activa. Llama a `switch_org`, o pasa `org`, antes de la primera llamada de datos. Cada llamada se ejecuta en una sola organización. Cada resultado empieza con el nombre y el id de la organización. Cada llamada comprueba tu membresía y tu acceso MCP en esa organización. La organización activa pertenece a la conexión. Si varios chats comparten una conexión, un cambio en un chat se aplica a todos. Si seleccionas una organización, la conexión funciona como antes. Para llegar a otras organizaciones, conéctate de nuevo y selecciona **All organizations**. ## Conectar con una clave de API [#conectar-con-una-clave-de-api] Usa este método para una integración desatendida que no necesite una identidad personal: | Campo de conexión | Valor | | --- | --- | | Nombre | Una etiqueta como `Sift reporting` | | URL | `https://mcp.getsift.ai/mcp` | | Transporte | HTTP / Streamable HTTP | | Nombre del encabezado | `Authorization` | | Valor del encabezado | `Bearer ` | Guarda la clave en el almacén de secretos o el entorno del cliente. No la pegues en un prompt de agente. MCP usa un encabezado bearer. La API REST usa `X-API-Key`; estas son configuraciones de conexión diferentes. La clave fija la organización. No proporciona identidad de usuario personal. Los valores predeterminados de la organización deben permitir el acceso MCP. Las claves no pueden usar herramientas de aplicación personal, Eventos ni confirmación de respuesta. Algunas operaciones requieren una persona incluso cuando una clave puede conectarse. Cada operación sigue verificando sus propias reglas de acceso. ## Entender los campos de acceso [#entender-los-campos-de-acceso] Los superadministradores configuran los controles de organización en la pestaña MCP. Los mismos controles se aplican a la CLI `sift`, que se conecta a través del servidor MCP: | Campo | Significado | | --- | --- | | `blocked` | Bloquea MCP para la organización. Anula todos los permisos de personas y roles. | | `sendBlocked` | Bloquea el envío a través de MCP. El resto del trabajo MCP permitido puede continuar. | | `defaultAccess` | Permiso predeterminado para usar MCP. Las claves de organización requieren que esto esté permitido. | | `defaultSend` | Permiso predeterminado para enviar a través de MCP. La confirmación humana sigue aplicando. | Los roles otorgan **Usar MCP** y **Enviar a través de MCP** en **Personas y acceso**. Las anulaciones de usuario usan **Heredar**, **Permitir** o **Bloquear** para cada capacidad. Un bloqueo de usuario anula un permiso de rol. Los bloqueos de organización anulan todos los permisos. Los resultados efectivos usan `useMcp` y `sendMcp`. Estos reportan el acceso permitido, no una promesa de entrega. Las organizaciones nuevas no tienen acceso MCP por defecto. El envío está desactivado por defecto. Guardar un control de organización o usuario cambia la política efectiva. Un interruptor sin guardar no cambia el acceso. MCP nunca amplía el acceso a colas ni el acceso a cuentas de envío. ## Inspeccionar tus conexiones personales [#inspeccionar-tus-conexiones-personales] Cuando `execute` está disponible, inspecciona el contrato primero: ```js return await sift.spec("config.mcpConnection.list") ``` Luego lista tus autorizaciones: ```js const result = await sift.call("config.mcpConnection.list", { limit: 20 }) return result ``` | Entrada | Tipo y comportamiento | | --- | --- | | `cursor` | Cadena opcional. Usa el `nextCursor` anterior. Omite en la primera página. | | `limit` | Entero opcional, 1-100. Predeterminado 50. | La lista devuelve `items`, `total` y `nextCursor`. Incluye conexiones expiradas y revocadas. No devuelve tokens bearer. | Campo de conexión | Significado | | --- | --- | | `id` | Identificador de conexión. Úsalo para la revocación. | | `clientId` | Identificador de cliente OAuth registrado. | | `createdAt` | Cuándo se creó la autorización. | | `expiresAt` | Cuándo expira la autorización. | | `revokedAt` | Cuándo fue revocada; `null` si no ha sido revocada. | | `type` | `mcpConnection` en los elementos de la lista. | | `name` | El identificador de cliente usado como etiqueta de la lista. | | `url`, `parent` | `null` en los elementos de la lista de conexiones. | Para revocar una conexión, lee `config.mcpConnection.delete` y llámalo solo con `id`. Revoca únicamente la conexión que el usuario solicita. Sus tokens de acceso dejan de funcionar en la siguiente solicitud. La revocación repetida devuelve el recibo original. Revocar la conexión actual puede terminar tu propio acceso. ## Solucionar problemas de conexión [#solucionar-problemas-de-conexión] | Síntoma | Siguiente paso | | --- | --- | | La autenticación falla o devuelve `401` | Verifica el encabezado o repite el inicio de sesión personal. Verifica la expiración y revocación del token. | | El acceso devuelve `403` | Verifica los bloqueos de organización, los permisos efectivos del usuario y el permiso requerido por la operación. | | `execute` no puede ejecutarse | Verifica el acceso al panel y el conjunto de herramientas disponibles para el llamador. | | Listening no puede ejecutarse | Verifica OAuth personal y la función Listening de la organización. | | Una sesión heredada devuelve `404` | Inicializa de nuevo y reanuda con tu cursor guardado. Conserva las cookies de enrutamiento. | | Los campos difieren de una lista de herramientas en caché | Reconecta o actualiza el servidor en tu gateway MCP. | | La confirmación no puede renderizarse | Usa el enlace de Sift autenticado. Abrir el enlace no aprueba la acción. | | Una vista de aplicación no puede renderizarse | Usa su texto, resultado estructurado o enlace de Sift. | Sift registra el llamador, el cliente, la entrada de la herramienta, el tiempo, el resultado y el tamaño de la respuesta para auditorías. El contenido de la respuesta no se registra en la auditoría de llamadas de herramientas MCP. Contacta a soporte para una revisión de acceso de organización. ## Consejos [#consejos] - Usa una clave de API por integración. - Verifica la organización antes de cada tarea. - Mantén conexiones separadas para entornos separados. - Trata `userId` como un campo de compatibilidad, no como una anulación de identidad. ## Relacionado [#relacionado] Inicia trabajo útil después de conectarte. Construye solicitudes a partir de campos exactos. Administra credenciales de servicio.