将 Notion 接入 Claude Code

通用 HTTP

在支持远程 Streamable HTTP MCP 和自定义请求头的客户端中，按下方参数添加远程 MCP 服务。完整密钥和团队信息从 OOMOL MCP 配置页获取；不同客户端的字段名称和配置格式可能不同。

URL

https://connector.oomol.com/v1/mcp

传输方式

Streamable HTTP

Authorization

Bearer <mcp-api-key>

x-oo-team-name

<team-name>

将占位符替换为自己的值。Authorization 使用 Bearer 加 MCP 密钥，x-oo-team-name 使用应用连接所在的团队名称。优先使用客户端的保密输入或环境变量功能。只填写 URL 而缺少这些请求头，配置仍不完整。

验证连接

1. 在客户端重新连接服务，确认能够列出 connector_list_apps 等 OOMOL 工具。如果连接失败，检查服务地址和两个认证请求头。
2. 在新的 AI 对话中执行只读验证任务，确认能读取目标资源及其数据。

Cursor

打开用户目录下的 ~/.cursor/mcp.json。如果文件不存在，用从 OOMOL 复制的 JSON 创建文件；如果已有配置，将 oomol 条目合并到现有 mcpServers 对象中。保存后重新连接服务，并新建一个 Agent 对话。

{
  "mcpServers": {
    "oomol": {
      "url": "https://connector.oomol.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer <mcp-api-key>",
        "x-oo-team-name": "<team-name>"
      }
    }
  }
}

验证连接

1. 在 Cursor 的 MCP 设置中启用 oomol，确认工具加载成功且没有认证错误，再新建一个启用该服务的 Agent 对话。
2. 在新的 AI 对话中执行只读验证任务，确认能读取目标资源及其数据。

Codex

打开 ~/.codex/config.toml，添加或更新唯一的 oomol 配置，将 <team-name> 替换为复制配置中的团队名称。在启动 Codex 的进程环境中设置 OOMOL_MCP_API_KEY，值为 Authorization 中的密钥本身，不包含 Bearer 前缀。删除 oomol.http_headers 中旧的 Authorization 项，不要把密钥写入 config.toml。使用该环境重新启动 Codex。

[mcp_servers.oomol]
url = "https://connector.oomol.com/v1/mcp"
bearer_token_env_var = "OOMOL_MCP_API_KEY"

[mcp_servers.oomol.http_headers]
"x-oo-team-name" = "<team-name>"

在 macOS 或 Linux 上使用 Codex CLI 和 Bash 时，运行以下命令，在不回显的提示处粘贴密钥。密钥只传给本次 Codex 进程，不会写入文件或命令历史。桌面端或 IDE 客户端需要在各自的启动环境中获得同名变量；另一个终端中设置的变量不一定可用。

bash -c '
read -r -s -p "OOMOL MCP API key: " OOMOL_MCP_API_KEY || exit 1
export OOMOL_MCP_API_KEY
exec codex
'

验证连接

1. 在 Codex CLI 中使用 /mcp 检查 oomol；桌面端或 IDE 客户端则查看其 MCP 状态。确认启动进程能读取 OOMOL_MCP_API_KEY，再新建对话。
2. 在新的 AI 对话中执行只读验证任务，确认能读取目标资源及其数据。

Claude Code

在项目根目录创建或合并下方 .mcp.json 配置，替换 <team-name>。在启动 Claude Code 的环境中设置 OOMOL_MCP_API_KEY，值为不含 Bearer 的密钥。下方 Bash 示例可在 macOS/Linux 中隐藏输入密钥并启动 claude。按提示批准项目服务后，用 /mcp 检查状态。

{
  "mcpServers": {
    "oomol": {
      "type": "http",
      "url": "https://connector.oomol.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${OOMOL_MCP_API_KEY}",
        "x-oo-team-name": "<team-name>"
      }
    }
  }
}

bash -c '
read -r -s -p "OOMOL MCP API key: " OOMOL_MCP_API_KEY || exit 1
export OOMOL_MCP_API_KEY
exec claude
'

验证连接

1. 在 Claude Code 中运行 /mcp，确认 oomol 已连接。如果认证失败，检查启动环境中的 OOMOL_MCP_API_KEY，再开启新对话。
2. 在新的 AI 对话中执行只读验证任务，确认能读取目标资源及其数据。

VS Code / GitHub Copilot

在 VS Code 中执行 MCP: Open User Configuration，将下方 servers 和 inputs 条目合并进去，保留已有配置。替换 <team-name> 并保存，再用 MCP: List Servers 启动 oomol。出现提示时输入不含 Bearer 的 MCP 密钥。保密输入可以避免将密钥写入此配置文件。

{
  "inputs": [
    {
      "type": "promptString",
      "id": "oomolMcpKey",
      "description": "OOMOL MCP API key",
      "password": true
    }
  ],
  "servers": {
    "oomol": {
      "type": "http",
      "url": "https://connector.oomol.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${input:oomolMcpKey}",
        "x-oo-team-name": "<team-name>"
      }
    }
  }
}

验证连接

1. 运行 MCP: List Servers，确认 oomol 正在运行，并在 Copilot 对话中启用其工具。如再次提示输入密钥，请填写不含 Bearer 的 MCP 密钥。
2. 在新的 AI 对话中执行只读验证任务，确认能读取目标资源及其数据。