Saltar al contenido principal

Conexión del Servidor MCP de ONLYOFFICE Apps a la Plataforma OpenAI usando encabezados personalizados

Introducción​

El Servidor MCP de ONLYOFFICE Apps es una herramienta para gestionar la interacción con modelos de lenguaje diseñada para mejorar la eficiencia, optimizar los flujos de trabajo impulsados por IA, la gestión de documentos y tareas, y aprovechar todo el potencial de ONLYOFFICE Apps.

El Servidor MCP de ONLYOFFICE Apps puede conectarse a clientes que admitan la conexión a servidores MCP que se ejecutan en una máquina remota.

La instancia pública está disponible en https://mcp.onlyoffice.com/mcp para clientes que admiten el transporte HTTP Streamable moderno y en https://mcp.onlyoffice.com/sse para clientes que solo admiten el transporte SSE heredado. Recomendamos usar el transporte HTTP Streamable siempre que sea posible.

Estas instrucciones demuestran cómo conectar un cliente MCP a un servidor MCP remoto usando encabezados personalizados, siempre que dicho cliente le permita pasar encabezados personalizados. Use este método de autenticación solo si no puede usar OAuth por algún motivo, ya que este método es menos seguro.

Para conectar el Servidor MCP de ONLYOFFICE Apps a la Plataforma OpenAI:

  1. Genere su propia clave API de Apps. El método de autenticación con encabezados personalizados es menos seguro en comparación con OAuth, por lo tanto no es recomendable usar las claves API del Propietario o del Administrador de sala. Para generar una clave API, vaya a su Apps. Haga clic en la pestaña Herramientas de desarrollo en el panel izquierdo. Elija la pestaña Claves API en la parte superior y haga clic en el botón Crear nueva clave secreta. Copie la clave generada.

    Generar clave API

  2. Acceda a su cuenta de OpenAI y abra un nuevo prompt en Chat.

  3. Busque la opción Tools y haga clic en el botón Add.

    Añadir herramienta

  4. En la ventana que se abre, haga clic en Server en la esquina superior derecha.

    Añadir servidor

  5. Rellene los parámetros requeridos del servidor MCP:

    Parámetros del servidor MCP

    • URL:

      https://mcp.onlyoffice.com/mcp

    • Label – introduzca el nombre para distinguir el servidor MCP.

    • Description – proporcione una breve descripción del servidor MCP para mejorar su identificación. Es un parámetro opcional.

    • Authentication – defina el método de autenticación y los ajustes. Elija Custom headers en la lista desplegable y use su clave API de DocSpace y la URL base de su portal Apps para conectarse. Rellene los campos que se abren de la siguiente manera:

      X-Mcp-Base-Url: https://your-instance.onlyoffice.com/
      X-Mcp-Api-Key: sk-a499e...

      X-Mcp-Base-Url - dirección web de su Apps para que el servidor MCP se conecte al portal correcto.

      X-Mcp-Api-Key - la clave API de Apps que se ha generado como se describe en el paso 1 anterior para autorizar el acceso del servidor MCP a Apps.

      Encabezados del servidor MCP

  6. Haga clic en Connect y espere a que se establezca la conexión.

  7. En cuanto el servidor MCP se conecte, verá la lista de herramientas del servidor MCP. Elija las herramientas necesarias o elija todas, y haga clic en el botón Add en la parte inferior de la lista.

    Herramientas del servidor MCP

  8. Use el chat de OpenAI con las herramientas del Servidor MCP de Apps conectadas. Escriba su prompt y haga clic en Approve para confirmar la lista de herramientas usadas para responder a su prompt.

    Aprobar herramientas