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. Encuentra las acciones que necesita una tarea con su 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 usando Gmail", "crea un panel que liste mis proyectos de Linear"
• Sin inflación de herramientas. Solo se exponen 3 herramientas sin importar cuántas plataformas o acciones conectes. Una llamada encuentra cada acción que una tarea necesita, en todas las plataformas, con su documentación, para que la ventana de contexto de tu agente se mantenga limpia.
• Control de acceso granular. Restringe qué acciones, conexiones y niveles de permiso (lectura, escritura, administrador) tiene tu agente.
• Seguro por defecto. Todas las solicitudes se proxían a través 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 de Slack a #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 tres 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)
find_one_actions	Encuentra la acción para cada operación que una tarea necesita, en todas las plataformas, con su documentación, en una sola llamada; load obtiene más de un documento o el de una alternativa
execute_one_action	Ejecuta una acción de API en una plataforma conectada

Encontrar acciones

find_one_actions toma una entrada de requests por operación, cada una con un platform en formato kebab-case y un intent corto que nombra la operación por sí sola ("send a message to a channel", no el mensaje). Un task describe el trabajo completo en términos generales, y un ai_model nombra el modelo que pregunta; se pide a los agentes que envíen ambos con cada búsqueda, ya que la tarea ayuda a distinguir acciones similares. Para cada intención, el modelo de decisión de One elige la acción a usar; la respuesta la documenta, señala un sustituto cuando el modelo no estaba seguro y lista algunas alternativas. Los documentos grandes se devuelven como un resumen; llama a find_one_actions nuevamente con load: [{ action_id, section }] para una sección que omitió, full: true para el documento completo o toc: true para su tabla de contenidos. ONE_ACTION_IDS, ONE_PERMISSIONS y ONE_CONNECTION_KEYS se aplican a cada respuesta: una acción que rechazan nunca se ofrece, y cuando rechazan la elección del modelo, el siguiente candidato permitido ocupa su lugar.

Actualización desde 1.x: search_one_platform_actions y get_one_action_knowledge se eliminan. find_one_actions reemplaza a ambos.

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 elecciones se devuelven al agente a través del campo access de cada conexión, para que sepa qué puede ejecutar sin buscar.

Agrégalo a la configuración MCP de tu cliente. El endpoint habla el transporte HTTP Streamable:

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

Algunos clientes omiten type y toman 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 tres herramientas están disponibles.

Instalación con un clic:

El enlace de Windsurf abre la página de One en el mercado 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á 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 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. find_one_actions entonces devuelve el documento completo de cada acción elegida con cómo llamarla desde código, y una Guía de Código de Integración (URL de paso, encabezados x-one-*, variables de entorno ONE_SECRET / ONE_{PLATFORM}_CONNECTION_KEY, colocación solo en 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 a continuación ya está hecha por ti. Estos ejemplos son para referencia o configuraciones manuales.

Independiente

npx @withone/mcp

Claude Desktop / Cursor

Agrega lo siguiente a tu configuración 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 arriba se pueden pasar como banderas -e.

Seguridad

Todas las solicitudes a plataformas de terceros se autentican y se proxían a través 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