Ana içeriğe geç

ONLYOFFICE Apps MCP Sunucusunu OpenAI Platform'a Bağlama

Giriş​

ONLYOFFICE Apps MCP Sunucusu, dil modelleriyle etkileşimi yönetmeye yarayan bir araçtır. Verimliliği artırmak, yapay zeka destekli iş akışlarını, belge ve görev yönetimini kolaylaştırmak ve ONLYOFFICE Apps uygulamasının tüm potansiyelini ortaya çıkarmak için tasarlanmıştır.

ONLYOFFICE Apps MCP Sunucusu, uzak bir makinede çalışan MCP sunucularına bağlanmayı destekleyen istemcilere bağlanabilir.

Genel örnek, modern Streamable HTTP aktarımını destekleyen istemciler için https://mcp.onlyoffice.com/mcp adresinde, yalnızca eski SSE aktarımını destekleyen istemciler için https://mcp.onlyoffice.com/sse adresinde kullanılabilir. Mümkün olduğunda Streamable HTTP aktarımını kullanmanızı öneririz.

Bu talimatlar, bir MCP istemcisinin özel üst bilgi (header) iletmeye izin vermesi koşuluyla, istemciyi özel üst bilgilerle uzak bir MCP Sunucusuna nasıl bağlayacağınızı gösterir. Bu yöntemi yalnızca herhangi bir nedenle OAuth kullanamıyorsanız tercih edin, çünkü daha az güvenlidir.

ONLYOFFICE Apps MCP Sunucusunu OpenAI Platform'a bağlamak için:

  1. Kendi Apps API anahtarınızı oluşturun. Özel üst bilgi doğrulama yöntemi OAuth'a göre daha az güvenli olduğundan Sahibin veya Oda yöneticisinin API anahtarlarını kullanmanız önerilmez. API anahtarı oluşturmak için Apps'e gidin. Sol paneldeki Geliştirici Araçları sekmesine tıklayın. Üstteki API anahtarları sekmesini seçin ve Yeni gizli anahtar oluştur düğmesine tıklayın. Oluşturulan anahtarı kopyalayın.

    Generate API key

  2. OpenAI hesabınıza girin ve Chat bölümünde yeni bir istem açın.

  3. Tools seçeneğini bulun ve Add düğmesine tıklayın.

    Add tool

  4. Açılan pencerede sağ üst köşedeki Server seçeneğine tıklayın.

    Add server

  5. Gerekli MCP server parametrelerini girin:

    MCP server parameters

    • URL:

      https://mcp.onlyoffice.com/mcp
    • Label – MCP sunucusunu ayırt etmek için bir ad girin.

    • Description – sunucunun daha kolay tanınması için MCP Sunucusu hakkında kısa bir açıklama yazın. Bu parametre isteğe bağlıdır.

    • Authentication – doğrulama yöntemini ve ayarlarını belirleyin. Açılır listeden Custom headers seçeneğini belirleyin ve bağlanılacak Apps portalınızın DocSpaceAPI key ve base URL değerlerini kullanın. Açılan alanları aşağıdaki gibi doldurun:

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

      X-Mcp-Base-Url - MCP Sunucusunun doğru portala bağlanması için Apps web adresi.

      X-Mcp-Api-Key - MCP Sunucusunun Apps'e erişimini yetkilendirmek için yukarıdaki 1. adımda açıklandığı gibi oluşturulan Apps API anahtarı.

      MCP server headers

  6. Connect düğmesine tıklayın ve bağlantının kurulmasını bekleyin.

  7. MCP Sunucusu bağlanır bağlanmaz MCP sunucusu araçlarının listesini görürsünüz. Gerekli araçları veya tümünü seçin ve listenin altındaki Add düğmesine tıklayın.

    MCP Server tools

  8. OpenAI sohbetini, Apps MCP Sunucusu araçları bağlı olarak kullanın. İsteminizi yazın ve isteminize yanıt vermek için kullanılan araçların listesini onaylamak üzere Approve düğmesine tıklayın.

    Approve tools