Conexiones MCP

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 vistazoCopy Anchor Link

Qué estás viendoCopy Anchor Link

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 personalCopy Anchor Link

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 organizacionesCopy Anchor Link

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:

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 APICopy Anchor Link

Usa este método para una integración desatendida que no necesite una identidad personal:

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 accesoCopy Anchor Link

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:

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 personalesCopy Anchor Link

Cuando execute está disponible, inspecciona el contrato primero:

return await sift.spec("config.mcpConnection.list")

Luego lista tus autorizaciones:

const result = await sift.call("config.mcpConnection.list", { limit: 20 })
return result

La lista devuelve items, total y nextCursor. Incluye conexiones expiradas y revocadas. No devuelve tokens bearer.

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ónCopy Anchor Link

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.

ConsejosCopy Anchor Link

• 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.

RelacionadoCopy Anchor Link