One

Servidor MCP One

Sitio web  ·  Documentación  ·  Panel de control  ·  Registro de cambios  ·  X  ·  LinkedIn

Conecta tus agentes de IA a más de 700 aplicaciones a través de un único servidor MCP. Busca acciones, lee documentación y ejecuta llamadas a la API en distintas plataformas, sin tener que gestionar tokens de OAuth ni claves de API.

npm install -g @withone/cli
one init

Eso es todo. La CLI de One te pedirá tu clave de API (obtén una desde el panel de control de One) y configurará el servidor MCP para tu entorno: Claude Desktop, Cursor, Claude Code, Windsurf o cualquier agente compatible con MCP.

Capacidades

• Más de 700 plataformas. Gmail, Slack, Shopify, HubSpot, Stripe, Linear, QuickBooks y más.
• Ejecución en lenguaje natural. "lee mi último correo de Gmail", "envía un mensaje a #general en Slack"
• Generación de código. "crea un formulario para enviar correos con Gmail", "crea un panel que liste mis proyectos de Linear"
• Sin inflación de herramientas. Solo se exponen 4 herramientas, independientemente de cuántas plataformas o acciones conectes. Las acciones se basan en búsqueda, por lo que la ventana de contexto de tu agente se mantiene limpia.
• Control de acceso granular. Restringe qué acciones, conexiones y niveles de permiso (lectura, escritura, administración) puede usar tu agente.
• Seguro por defecto. Todas las solicitudes pasan por el proxy de One, los secretos se redactan automáticamente y no hay claves de API de plataformas que gestionar.

Ejemplos

Ejecuta acciones directamente:

"Obtén mis últimos 5 correos de Gmail"

"Envía un mensaje a Slack en #general: 'Reunión en 10 minutos'"

"Obtén todos los productos de mi tienda de Shopify"

Genera código de integración:

"Crea un componente de formulario en React que envíe correos usando Gmail"

"Crea un panel que muestre los usuarios de Linear y sus proyectos asignados con filtros"

"Crea una tabla paginable que obtenga y muestre facturas de QuickBooks con búsqueda y ordenamiento"

Herramientas

El servidor expone cuatro herramientas MCP:

Herramienta	Descripción
list_one_integrations	Lista las plataformas disponibles y las conexiones activas, cada una con el access que otorga (completo, métodos o acciones específicas)
search_one_platform_actions	Busca acciones en una plataforma específica
get_one_action_knowledge	Obtén documentación detallada de una acción
execute_one_action	Ejecuta una acción de API en una plataforma conectada

Servidor MCP remoto

¿Prefieres no ejecutar nada localmente? One aloja un servidor MCP remoto en https://mcp.withone.ai/mcp. Apunta cualquier cliente MCP que admita servidores remotos (HTTP) a esa URL y autentícate con One mediante OAuth. No hay npm install ni ONE_SECRET que gestionar. Apruebas el acceso en la pantalla de consentimiento de One, donde puedes delimitar exactamente qué conexiones, acciones y niveles de permiso recibe el agente. Esas opciones se devuelven al agente a través del campo access de cada conexión, para que sepa qué puede ejecutar sin necesidad de buscar.

Añádelo a la configuración MCP de tu cliente. El endpoint utiliza el transporte Streamable HTTP:

{
  "mcpServers": {
    "one": {
      "type": "http",
      "url": "https://mcp.withone.ai/mcp"
    }
  }
}

Algunos clientes omiten type y aceptan solo la URL; los clientes basados en interfaz (conectores personalizados) solo necesitan la URL. En la primera conexión, tu cliente abre un navegador para autenticarte y autorizar con One. Después, las mismas cuatro herramientas están disponibles.

Instalación con un clic:

El enlace de Windsurf abre la página de One en el mercado de MCP del editor, que se sirve desde el registro oficial de MCP donde One está publicado como ai.withone/mcp. Windsurf gestiona el inicio de sesión con OAuth por sí mismo una vez que instalas desde esa página.

Instalación manual

Si prefieres configurar el servidor manualmente en lugar de usar one init, instala el paquete directamente:

npm install @withone/mcp

Luego establece la variable de entorno requerida:

ONE_SECRET=your-one-secret-key

Delimitación de identidad

Delimita las conexiones a una identidad específica (por ejemplo, un usuario, equipo u organización):

ONE_IDENTITY=user_123
ONE_IDENTITY_TYPE=user

Variable	Descripción	Valores
ONE_IDENTITY	El identificador de la entidad (por ejemplo, ID de usuario, ID de equipo)	Cualquier cadena
ONE_IDENTITY_TYPE	El tipo de identidad	user, team, organization, project

Cuando se establece, el servidor MCP solo devolverá las conexiones asociadas con la identidad especificada. Esto es útil para aplicaciones multiinquilino donde quieres delimitar las integraciones a usuarios o entidades específicos.

Control de acceso

Ajusta con precisión lo que el servidor MCP puede ver y hacer:

ONE_PERMISSIONS=read
ONE_CONNECTION_KEYS=conn_key_1,conn_key_2
ONE_ACTION_IDS=action_id_1,action_id_2
ONE_KNOWLEDGE_AGENT=true

Variable	Tipo	Predeterminado	Descripción
ONE_PERMISSIONS	read | write | admin	admin	Filtra las acciones por método HTTP. read = solo GET, write = GET/POST/PUT/PATCH, admin = todos los métodos
ONE_CONNECTION_KEYS	* o claves separadas por comas	*	Restringe las conexiones y plataformas visibles a claves de conexión específicas
ONE_ACTION_IDS	* o IDs separados por comas	*	Restringe las acciones visibles y ejecutables a IDs de acción específicos
ONE_KNOWLEDGE_AGENT	true | false	false	Elimina la herramienta execute_one_action por completo, forzando el modo solo conocimiento. Las respuestas de get_one_action_knowledge incluyen además una Guía de código de integración (URL de paso, encabezados x-one-*, variables de entorno ONE_SECRET / ONE_{PLATFORM}_CONNECTION_KEY, ubicación solo backend) para escribir código de aplicación

Todos los valores predeterminados preservan el comportamiento actual. Si no se establecen variables de entorno de control de acceso, el servidor se inicia con acceso completo y todas las herramientas disponibles.

Lo que configures aquí se devuelve al agente: list_one_integrations sella cada conexión con un campo access para que el agente sepa de antemano qué puede ejecutar allí, sin gastar un turno buscando. Es uno de:

access	Cuándo
{ "policy": "full" }	Sin lista de permitidos de acciones y ONE_PERMISSIONS=admin — cada acción es ejecutable.
{ "policy": "methods", "methods": ["GET", ...] }	Sin lista de permitidos de acciones, pero ONE_PERMISSIONS es read/write — solo estos métodos HTTP son ejecutables.
{ "policy": "actions", "actions": [{ "actionId", "title", "method" }] }	ONE_ACTION_IDS está establecido — exactamente estas acciones (las de la plataforma de esa conexión) son ejecutables, por lo que no se necesita búsqueda.

Configuración manual

Si usaste one init, la configuración siguiente ya está hecha por ti. Estos ejemplos son para referencia o configuraciones manuales.

Independiente

npx @withone/mcp

Claude Desktop / Cursor

Añade lo siguiente a tu configuración de MCP:

• Claude Desktop: MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json · Windows: %APPDATA%/Claude/claude_desktop_config.json
• Cursor: Abre el menú de Cursor y selecciona "Configuración de MCP"

{
  "mcpServers": {
    "one": {
      "command": "npx",
      "args": ["@withone/mcp"],
      "env": {
        "ONE_SECRET": "your-one-secret-key"
      }
    }
  }
}

Docker

docker build -t one-mcp-server .
docker run -e ONE_SECRET=your_one_secret_key one-mcp-server

Todas las variables de entorno listadas anteriormente se pueden pasar como banderas -e.

Seguridad

Todas las solicitudes a plataformas de terceros se autentican y pasan por el proxy de la API de One. El servidor MCP nunca maneja tokens de OAuth ni claves de API de plataformas directamente. La clave ONE_SECRET es la única credencial requerida, y se redacta automáticamente de todas las cargas útiles de respuesta devueltas a los clientes. Los encabezados sensibles se eliminan de las configuraciones de solicitud registradas y devueltas.

Licencia

MIT

Soporte

Para soporte, contacta a support@withone.ai o visita https://withone.ai