Offorte MCP Server

🚀 Offorte MCP 服務器

Offorte 的 MCP 服務器可藉助人工智能創建併發送提案。它充當人工智能代理與 Offorte 提案引擎之間的橋樑，使外部模型能夠通過 Offorte 創建併發送提案。專為自動化工作流程而構建的 MCP 可輕鬆將提案操作集成到人工智能工具、聊天界面和自主系統中。

⚠️ 重要提示

請注意，MCP（模型上下文協議）是一種全新的人工智能集成方法。雖然功能強大，但它仍在不斷發展，偶爾可能會產生意外或不理想的結果。

🚀 快速開始

項目背景

本項目旨在藉助協議利用人工智能創建併發送提案。由於該項目處於實驗階段，因此並未涵蓋完整的 Offorte API，僅包含創建和發送提案所需的工具。目前尚未實現可能導致大語言模型更新和刪除內容的工具。未來，我們將根據實際使用效果和用戶反饋，考慮添加更新和刪除命令。

前置條件

• Node.js（已在 Node.js 20.x.x 版本上進行測試）
• Offorte API 密鑰（請參閱 Offorte API 文檔的 身份驗證部分）
• 開發時需使用 PNPM
• TRANSPORT_TYPE（可選）：設置為 sse 可啟用服務器發送事件（SSE）模式，不設置或使用默認值則為 stdio（默認值：stdio）。

開發步驟

若要開始開發，請克隆倉庫並安裝依賴項。確保你擁有 .env 文件，幷包含正確的值。

git clone https://github.com/offorte/offorte-mcp-server.git
cd offorte-mcp-server
pnpm install
pnpm dev

命令說明

查看 NPM 腳本以瞭解所有命令，以下是最重要命令的簡要總結：

✨ 主要特性

關於 Offorte

Offorte 是一款自動化提案軟件，可幫助企業創建、發送和跟蹤精美且交互式的提案。它專為速度、靈活性和實際應用而構建，在不犧牲個性化的前提下，將自動化與智能工作流程相結合。瞭解更多關於 Offorte 的信息。

API

MCP 服務器使用 Offorte 公共 API v2。如需瞭解更多信息，請閱讀 API 文檔。

演示

體驗提案的未來：語音觸發、人工智能驅動、完全自動化。查看 Offorte 如何在 此真實演示 中連接語音和工作流程。

📦 安裝指南

目前文檔未提及具體安裝步驟相關內容，可參考開發步驟進行操作。

💻 使用示例

基礎用法

目前文檔未提供基礎用法的代碼示例。

高級用法

目前文檔未提供高級用法的代碼示例。

📚 詳細文檔

可用工具

上下文與設置

• get_initial_context – 重要提示：在使用任何其他工具之前，必須調用此工具以初始化上下文並獲取使用說明。

賬戶

• get_users – 列出當前賬戶的所有用戶。

自動化

• get_automation_sets – 列出用作創建新提案可選輸入的自動化集。

聯繫人

• create_contact – 創建新聯繫人（組織或個人）。
• get_contact_details - 按 ID 獲取聯繫人的所有詳細信息。
• search_contact_organisations - 在聯繫人中按名稱搜索組織。
• search_contact_people - 在聯繫人中按名稱搜索人員。

收藏夾

• get_proposal_templates – 列出用作創建新提案起點的提案模板。

提案

• create_proposal – 創建新提案。
• get_proposal_directories – 按狀態分組獲取所有提案目錄。
• search_proposals – 按查詢條件搜索提案。
• send_proposal – 將提案發送給指定聯繫人。

設置

• get_design_templates – 列出用於創建新提案的可用設計模板。
• get_email_templates – 列出用於發送提案的可用電子郵件模板。
• get_text_templates – 列出用於創建新提案的可用語言文本模板。

MCP 客戶端

目前，此 MCP 服務器僅在 Claude Desktop 上進行了測試。未來將添加更多客戶端示例。

Claude Desktop 配置

在 Claude > 設置 > 開發者 > 編輯配置 中找到 claude_desktop_config.json，並根據你的需求添加以下 僅一項 配置：

NPX

直接從 npm 註冊表運行。

{
    "mcpServers": {
        "offorte-proposals": {
            "command": "npx",
            "args": ["-y", "@offorte/mcp-server"],
            "env": {
                "OFFORTE_ACCOUNT_NAME": "<YOUR_ACCOUNT_NAME>",
                "OFFORTE_API_KEY": "<YOUR_TOKEN>"
            }
        }
    }
}

本地 Node

在使用此方法之前，應先安裝依賴項並構建項目（pnpm install）。

{
    "mcpServers": {
        "offorte-proposals": {
            "command": "node",
            "args": ["/path/to/directory/offorte-mcp-server/dist/server.js"],
            "env": {
                "OFFORTE_ACCOUNT_NAME": "<YOUR_ACCOUNT_NAME>",
                "OFFORTE_API_KEY": "<YOUR_TOKEN>"
            }
        }
    }
}

🔧 技術細節

目前文檔未提供具體技術細節相關內容。

📄 許可證

目前文檔未提供許可證信息。