HubSpot MCP服务器

HubSpot MCP服务器

基于FastMCP的MCP服务器，用于HubSpot CRM工具。

安装（本地）

1. 创建虚拟环境：
   • uv venv
2. 安装依赖项：
   • uv sync

配置

设置以下环境变量之一：

• HUBSPOT_ACCESS_TOKEN_FILE：包含HubSpot Private App令牌的文件的路径。

示例（zsh）：

export HUBSPOT_ACCESS_TOKEN_FILE="$HOME/.secrets/hubspot_token"

可选：

• HUBSPOT_BASE_URL （默认为 https://api.hubapi.com)
• HubSpot私有应用程序范围应包括启用工具使用的CRM读取范围。
• 属性架构管理工具需要相关的CRM属性/架构权限 目标对象类型。
• 电子邮件参与阅读额外要求 sales-email-read.

跑

uv run python -m src.server

CLI使用情况

python -m src.cli --tool <tool_name> --payload '<json>'

分布

看 docs/distribution.md 用于包装和分销说明。

在OpenAI Codex CLI中安装

1. 确保安装了依赖项（请参阅上面的安装）。
2. 集 HUBSPOT_ACCESS_TOKEN_FILE 在您启动Codex的环境中。
3. 使用正常的“添加服务器”流程将此MCP服务器添加到Codex CLI，将其指向此仓库和入口点：
   • 命令： uv run python -m src.server

将服务器添加到Codex CLI后，是否可以访问env令牌？

是的，只要Codex从shell/会话启动MCP服务器，其中 HUBSPOT_ACCESS_TOKEN_FILE 设置后，服务器将继承该环境变量。如果Codex使用自己的环境配置，请确保变量也设置在那里（或在启动Codex之前导出）。