Offorte MCP Server

Offorte MCP 服务

Offorte 的 MCP 服务 - 使用 AI 创建并发送提案。

此服务充当 AI Agent 与 Offorte 提案引擎之间的桥梁。 它支持外部模型通过 Offorte 创建并发送提案。 此 MCP 专为自动化工作流打造，可轻松将提案操作集成到 AI 工具、聊天界面和自主系统中。

早期技术 请注意，MCP（Model Context Protocol）是一种新的 AI 集成方式。 虽然功能强大，但仍在不断发展，有时可能会产生意外或不理想的结果。

目录

• 关于 Offorte
• 目标与覆盖范围
• 先决条件
• 可用工具
• MCP 客户端
• 开发

关于 Offorte

Offorte 是一款自动化提案软件，可帮助企业创建、发送和跟踪精美的交互式提案。 它专为速度、灵活性和实际应用而打造，将自动化与智能工作流相结合，同时不失个性化体验。 了解有关 Offorte 的更多信息。

API

此 MCP 服务使用 Offorte Public API v2。 请阅读 API 文档以了解更多信息。

演示

体验提案的未来：语音触发、AI 驱动、全自动化。 观看 Offorte 如何在这个真实演示中连接语音与工作流。

目标与覆盖范围

本项目的目标是通过该协议使用 AI 创建并发送提案。 由于其具有实验性质，项目并未涵盖完整的 Offorte API，仅包含创建和发送提案所需的工具。 可能导致大模型更新和删除内容的工具尚未实现。 未来可能会根据实际使用结果和用户反馈添加更新和删除命令。

先决条件

• Node.js（已使用 Node.js 20.x.x 测试）
• Offorte API Key（请参阅 Offorte API 文档的身份验证部分）
• 用于开发的 PNPM
• TRANSPORT_TYPE（可选）：设为 sse 以启用 Server-Sent Events（SSE）模式；留空或使用默认值则采用 stdio（默认值：stdio）。

可用工具

上下文与设置

• 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 > Settings > Developer > Edit Config 中找到 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>"
			}
		}
	}
}

开发

首先，克隆此代码库并安装依赖项。 确保你有一个 .env 文件，并且其中包含正确的值。

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

命令

查看 NPM 脚本以了解所有命令，以下是最重要命令的简要概述。

脚本	说明
pnpm build	构建用于生产环境的项目
pnpm start	启动生产环境服务器
pnpm dev	启动开发服务器
pnpm inspect	检查服务器
pnpm format	使用 Prettier 和 ESLint 格式化代码