FP MCP-configuration-template

Claude代码的MCP服务器配置

此存储库包含MCP（模型上下文协议）服务器的设置说明，用于将Notion、Jira和Slack与Claude Code集成。

什么是MCP？

MCP（模型上下文协议）使Claude Code能够与外部服务集成。使用MCP服务器，Claude可以：

• 在Notion中读取和创建页面
• 在Jira中管理任务
• 在Slack中阅读和发送消息
• 在所有工作区工具中搜索
• 使用数据库等

需求

• Node.js>=18.0.0
• 克劳德代码
• Kateryna或Kostyantyn的API密钥

快速设置

1.获取API密钥

重要： 安装前，请从以下位置请求API密钥：

• 凯瑟琳 - kateryna@keplercommerce.com
• Koshyn - kostyantyn@keplercommerce.com

您将需要：

• NOTION_API_KEY -用于Notion访问
• JIRA_HOST -Jira主机（keplercommerce.atlassian.net）
• JIRA_EMAIL -您的Jira电子邮件
• JIRA_API_TOKEN -Jira代币
• JIRA_BOARD_ID -板ID（可选，请参阅下面的可用板）
• SLACK_MCP_XOXC_TOKEN -Slack浏览器令牌（您可以自己提取）
• SLACK_MCP_XOXD_TOKEN -Slack浏览器cookie（您可以自己提取）

2.克隆此存储库

# Clone the repository with both MCP servers
git clone https://github.com/KSolovtsov/FP_mcp-configuration-template.git
cd FP_mcp-configuration-template

存储库包括：

• notion-mcp-enhanced/ -完整的Notion MCP服务器及其源代码
• jira-mcp-server/ -完整的Jira MCP服务器及其源代码
• slack-mcp-server/ -完整的Slack MCP服务器及其源代码
• 配置模板和示例
• 完整的API文档（200多种Slack方法）

3.安装依赖项

# Notion MCP
cd notion-mcp-enhanced
npm install
npm run build

# Jira MCP
cd ../jira-mcp-server
npm install
npm run build

# Slack MCP (Go-based, no npm install needed)
cd ../slack-mcp-server
# Slack MCP can be used via NPX or local build
# See Slack-specific instructions below

4.创建.env文件

MCP概念

创建 .env 文件在 notion-mcp-enhanced 文件夹：

NOTION_API_KEY=your_key_from_kateryna_or_kostyantyn

Jira MCP

创建 .env 文件在 jira-mcp-server 文件夹：

JIRA_HOST=keplercommerce.atlassian.net
JIRA_EMAIL=your_email@keplercommerce.com
JIRA_API_TOKEN=your_token_from_kateryna_or_kostyantyn
JIRA_BOARD_ID=268

项目信息：

• 项目密钥：PROD
• 项目Url: https://keplercommerce.atlassian.net/jira/software/c/projects/PROD
• 项目名称：门户/SAAS

可用板（PROD项目）：

• 268 -产品（Scrum）-默认板
• 298 -所有工作/门户（Scrum）
• 232 -工程（Scrum）
• 167 -列表优化（Scrum）
• 166 -广告委员会（Scrum）
• 265 -QA（看板）
• 266 -业务流程（Scrum）
• 267 -报告（Scrum）

选择合适的 JIRA_BOARD_ID 基于你的团队。

松弛MCP

创建 .env 文件在 slack-mcp-server 文件夹：

SLACK_MCP_XOXC_TOKEN=xoxc-your-token-here
SLACK_MCP_XOXD_TOKEN=xoxd-your-cookie-here
SLACK_MCP_LOG_LEVEL=info
SLACK_MCP_ADD_MESSAGE_TOOL=false

如何获取Slack代币：

1. 在浏览器中打开Slack（Chrome/Firefox）
2. 打开开发人员工具（F12）
3. 转到“网络”选项卡
4. 刷新页面
5. 查找任何请求 api.slack.com
6. 在标题中，找到：

- Authorization: Bearer xoxc-... → Your SLACK_MCP_XOXC_TOKEN - Cookie: d=xoxd-... → Your SLACK_MCP_XOXD_TOKEN

重要提示： 这些是你的个人代币。每个团队成员都需要有自己的。

替换：

• your_key_from_kateryna_or_kostyantyn -钥匙来自Kateryna/Kostyantyn
• your_email@keplercommerce.com -使用您的工作电子邮件
• your_token_from_kateryna_or_kostyantyn -Kateryna/Kostyantyn的令牌
• xoxc-your-token-here -使用您的Slack xoxc令牌（提取您自己）
• xoxd-your-cookie-here -使用您的Slack xoxd cookie（提取您自己）

5.配置克劳德代码

查找配置文件：

窗户：

%APPDATA%\Claude\claude_desktop_config.json

macOS：

~/Library/Application Support/Claude/claude_desktop_config.json

将MCP服务器添加到配置中：

{
  "mcpServers": {
    "notion": {
      "command": "node",
      "args": [
        "/path/to/FP_mcp-configuration-template/notion-mcp-enhanced/dist/index.js"
      ],
      "env": {
        "NOTION_API_KEY": "your_key_from_kateryna_or_kostyantyn"
      }
    },
    "jira": {
      "command": "node",
      "args": [
        "/path/to/FP_mcp-configuration-template/jira-mcp-server/dist/index.js"
      ],
      "env": {
        "JIRA_HOST": "keplercommerce.atlassian.net",
        "JIRA_EMAIL": "your_email@keplercommerce.com",
        "JIRA_API_TOKEN": "your_token_from_kateryna_or_kostyantyn",
        "JIRA_BOARD_ID": "268"
      }
    },
    "slack": {
      "command": "npx",
      "args": [
        "-y",
        "slack-mcp-server@latest",
        "--transport",
        "stdio"
      ],
      "env": {
        "SLACK_MCP_XOXC_TOKEN": "xoxc-your-token-here",
        "SLACK_MCP_XOXD_TOKEN": "xoxd-your-cookie-here",
        "SLACK_MCP_LOG_LEVEL": "info"
      }
    }
  }
}

Windows路径示例：

"C:/Users/YourUsername/FP_mcp-configuration-template/notion-mcp-enhanced/dist/index.js"

macOS/Linux路径示例：

"/Users/YourUsername/FP_mcp-configuration-template/notion-mcp-enhanced/dist/index.js"

6.重新启动克劳德代码

完全关闭并重新打开Claude Code。

验证安装

启动Claude Code后，尝试：

关于理念：

Show my recent Notion pages

对于Jira：

Show my open Jira issues

对于Slack：

List my Slack channels
Show recent messages from #general

安全

关键：

• ❌ 不要承诺 .env 文件到Git
• ❌ 请勿在聊天/电子邮件中共享API密钥
• ❌ 不要在公共存储库中发布密钥
• ✅ 仅将钥匙保存在本地 .env 文件
• ✅ 如有需要，向Kateryna/Kostyantyn申请新钥匙

故障排除

MCP服务器无法启动

1. 检查Node.js版本：

node --version

应大于等于18.0.0

1. 重新安装依赖关系：

npm install
npm run build

Claude看不到MCP服务器

1. 验证中的路径 claude_desktop_config.json
2. 确保 .env 文件存在并已填充
3. 完全重新启动Claude Code

授权错误

1. 验证API密钥是否正确
2. 检查中是否有多余的空间 .env 文件
3. 联系Kateryna或Kostyantyn获取新钥匙

特性

MCP概念

• 搜索和阅读页面
• 创建和编辑页面
• 使用数据库
• 过滤器和排序
• 阻止内容管理

Jira MCP

• 搜索问题（JQL查询）
• 创建和更新问题
• 使用短跑和板
• 评论和状态转换
• 主要关注PROD项目 （门户网站/SAAS）
• 访问8个不同的板（产品、工程、QA等）

松弛MCP

• 从频道和DM读取消息
• 使用过滤器（日期、用户、内容）搜索邮件
• 列出所有频道（公共、私人、DM、组）
• 发送消息（可选，默认禁用）
• 线程支持（阅读和回复）
• 智能历史记录提取（按日期或计数）
• 完整的API文件 -记录了200多种Slack方法
• AI友好 -快速搜索和示例

API密钥联系人

• 凯瑟琳 - kateryna@keplercommerce.com
• Koshyn - kostyantyn@keplercommerce.com

许可证

麻省理工学院