内容
# 全inTech MCP 客户端 - 连接 Claude Desktop 以获取商业分析
## ✨ 适用于 Claude Desktop 免费和专业/最大层级的工具！ ✨
---
## 📚 目录
- [🚀 什么是全inTech？](#-什么是全intech)
- [🧠 为什么使用 MCP（模型上下文协议）？](#-为什么使用-mcp模型上下文协议)
- [📦 您将获得的工具：16 种强大的工具](#-您将获得的工具16-种强大的工具)
- [🚀 设置指南](#-设置指南)
- [适用于 Claude Pro/Max 用户（1 分钟！）](#适用于-claude-promax-用户1-分钟)
- [适用于 Claude 免费用户（5 分钟）](#适用于-claude-免费用户5-分钟)
- [🛠️ 您将获得的工具](#️-您将获得的工具)
- [💬 向 Claude 提问的示例](#-向-claude-提问的示例)
- [🔧 故障排除](#-故障排除)
- [📚 附加文档](#-附加文档)
- [❓ 常见问题](#-常见问题)
- [📋 要求](#-要求)
---
## 🚀 什么是全inTech？
**使命：** 使企业级 AI 可用于中小企业，这些企业因复杂、分散和昂贵的解决方案而被落 behind。
**我们解决的问题：**
- 中小企业每年在 7+ 个不相关的 AI 工具上花费 10,000 美元以上
- 84% 的企业愿意实现自动化，但缺乏集成、经济的解决方案
- 75% 的中小企业正在尝试 AI，但没有人专门为他们构建
- 现金流不确定性、运营时间浪费、复杂性 overload
**我们的解决方案：**
“商业运营的 Shopify” - 一个 AI 驱动的平台，替代 7+ 个工具，成本为企业软件的 1/10。
---
## 🧠 为什么使用 MCP（模型上下文协议）？
**什么是 MCP？**
MCP 是由 Anthropic（Claude AI 的创造者）创建的开放标准，它实现了 AI 助手和商业数据来源之间的安全双向连接。
**可以将其视为：** “AI 集成的 USB 标准”
**为什么它具有革命性：**
- **传统 AI：** “我无法访问您的数据。以下是通用建议...”
- **使用 MCP：** AI 安全地访问您的实际商业数据
- **结果：** 3 秒内获得有关您企业的具体答案，而不是通用响应
**我们的技术创新：**
- 比传统方法快 95%（3 秒 vs 30 秒响应）
- 比传统方法便宜 95%（每查询 $0.03 vs $0.50）
- 在 Google Cloud Run 上部署，带有 Streamable HTTP 传输
- 实时、智能自动化，理解您的业务
**它如何帮助您：**
- 用普通英语提问：“下个月我的现金流如何？”
- 获取即时答案和您的实际数据：“您的余额将为 $60,630”
- 主动洞察：“警告：7 月 15 日现金缺口 - 立即联系客户 ABC”
---
## 📦 您将获得的工具：16 种强大的工具
此文件夹包含连接 **Claude Desktop** 到 **全inTech MCP 服务器** 以获取强大的商业分析所需的一切。
---
## 📦 文件夹中有什么？
- `stdio_client.py` - 唯一需要的文件（连接 Claude Desktop 到我们的 MCP 服务器）
---
## 🚀 设置指南
### 适用于 Claude Pro/Max 用户（1 分钟！） 💎
**您有最简单的设置 - 不需要文件！**
#### 步骤 1：下载 Claude Desktop
- 前往：https://claude.ai/download
- 为您的操作系统下载并安装 **Claude Desktop**
#### 步骤 2：添加连接器
1. 打开 **Claude Desktop**
2. 进入 **设置** → **连接器**
3. 点击 **“添加连接器”**
4. 输入：
- **名称：** `全inTech`
- **网址：** `https://allintech-mcp-server-588831597903.us-central1.run.app/sse`
5. 点击 **保存**
#### 步骤 3：重启和测试
1. **重启 Claude Desktop**（完全退出并重新打开）
2. 问 Claude：**“您有哪些工具可以使用？”**
3. 您应该看到 **15 个全inTech 工具** 列出！
**完成！** 🎉
---
### 适用于 Claude 免费用户（5 分钟）
**您需要下载此文件并配置它：**
#### 步骤 1：前提 - 安装 Python 和所需包
**⚠️ 重要：您必须在继续之前安装这些。**
**检查 Python 是否已安装：**
```bash
# Mac/Linux
python3 --version
# Windows
python --version
```
**如果 Python 未安装：**
**在 Mac 上：**
```bash
# 首先安装 Homebrew（如果未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 安装 Python 3
brew install python3
```
**在 Windows 上：**
1. 从 https://www.python.org/downloads/ 下载 Python
2. 在安装过程中，**勾选** “将 Python 添加到 PATH”
3. 完成安装
**安装 httpx 包（MCP 客户端工作所需）：**
```bash
# Mac/Linux
pip3 install httpx
# Windows
pip install httpx
```
**✅ 验证 httpx 已安装：**
```bash
# Mac/Linux
pip3 show httpx
# Windows
pip show httpx
```
#### 步骤 2：下载 Claude Desktop
- 前往：https://claude.ai/download
- 为您的操作系统下载并安装 **Claude Desktop**
#### 步骤 3：下载和设置客户端文件
**选项 A：直接文件下载（最快 - 推荐）**
**在 Mac/Linux 上：**
```bash
# 创建文件夹
mkdir -p ~/allintech-mcp
cd ~/allintech-mcp
# 直接下载 stdio_client.py 文件
curl -o stdio_client.py https://raw.githubusercontent.com/The-Allin/theallintech-mcp-business-analytics/main/client/stdio_client.py
# 获取完整路径（复制此路径用于配置！）
echo "完整路径：$(pwd)/stdio_client.py"
```
**在 Windows 上：**
1. **直接下载：** 点击此处下载 → [stdio_client.py](https://raw.githubusercontent.com/The-Allin/theallintech-mcp-business-analytics/main/client/stdio_client.py)
2. 右键单击 → **另存为** → 保存到：`C:\Users\您的用户名\allintech-mcp\stdio_client.py`
**选项 B：克隆完整仓库**
```bash
# 克隆仓库
git clone https://github.com/The-Allin/theallintech-mcp-business-analytics.git
cd theallintech-mcp-business-analytics/client
# 获取完整路径
echo "完整路径：$(pwd)/stdio_client.py"
```
#### 步骤 4：配置 Claude Desktop 配置文件
**📍 准确的配置文件位置：**
**对于 Mac：**
```
/Users/您的用户名/Library/Application Support/Claude/claude_desktop_config.json
```
**对于 Windows：**
```
C:\Users\您的用户名\AppData\Roaming\Claude\claude_desktop_config.json
```
---
**🔧 如何打开配置文件：**
**在 Mac 上：**
1. 打开 **终端** 并运行此命令直接打开配置文件：
```bash
open -a TextEdit ~/Library/Application\ Support/Claude/claude_desktop_config.json
```
**或** 手动：
1. 打开 **Finder**
2. 按 `Cmd + Shift + G`
3. 粘贴：`~/Library/Application Support/Claude/`
4. 双击 `claude_desktop_config.json`（在 TextEdit 中打开）
**在 Windows 上：**
1. 按 `Win + R`（打开运行对话框）
2. 输入或粘贴：`%APPDATA%\Claude`
3. 按 **Enter**
4. 找到并打开 `claude_desktop_config.json` 与 **Notepad**
---
**✏️ 添加到配置文件：**
**⚠️ 关键 - 阅读此内容：**
- **使用完整路径** 从步骤 3（`echo "完整路径：..."` 命令的输出）
- **不要** 手动输入您的用户名或猜测路径
- **复制并粘贴** 准确的路径
**重要：** 配置文件必须是有效的 JSON。如果文件为空或仅包含 `{}，` 请用以下配置替换。
**对于 Mac 用户：**
```json
{
"mcpServers": {
"allintech": {
"command": "python3",
"args": [
"粘贴您的完整路径"
]
}
}
}
```
**对于 Windows 用户：**
```json
{
"mcpServers": {
"allintech": {
"command": "python",
"args": [
"粘贴您的完整路径"
]
}
}
}
```
**✅ 正确方式：从终端复制路径**
**在 Mac 上：**
```bash
# 您在步骤 3 中运行了此命令：
cd ~/allintech-mcp
echo "完整路径：$(pwd)/stdio_client.py"
# 输出示例：
# 完整路径：/Users/john/allintech-mcp/stdio_client.py
# ✅ 复制此完整路径 ↑ 并粘贴到您的配置中！
```
**在 Windows 上：**
```bash
# 导航到文件资源管理器中的文件夹
# 点击地址栏
# 复制路径：C:\Users\john\allintech-mcp
# 添加 \stdio_client.py 到末尾
# 结果：C:\Users\john\allintech-mcp\stdio_client.py
# ✅ 复制此完整路径 ↑ 并粘贴到您的配置中！
```
**示例 - 正确的配置（Mac）：**
```json
{
"mcpServers": {
"allintech": {
"command": "python3",
"args": [
"/Users/john/allintech-mcp/stdio_client.py"
]
}
}
}
```
**示例 - 正确的配置（Windows）：**
```json
{
"mcpServers": {
"allintech": {
"command": "python",
"args": [
"C:\\Users\\john\\allintech-mcp\\stdio_client.py"
]
}
}
}
```
**🚨 避免常见错误：**
- ❌ 输入 `YOUR_USERNAME` 字面文本
- ❌ 忘记替换占位符文本
- ❌ 使用相对路径，如 `~/allintech-mcp/stdio_client.py`
- ❌ 忘记 Windows 上使用 `\\`（双反斜杠）
- ❌ 遗漏 `.py` 文件扩展名
- ✅ **始终使用步骤 3 中的完整绝对路径**
#### 步骤 5：重启和测试
1. **保存** 配置文件（`Cmd+S` 在 Mac 上，或 `Ctrl+S` 在 Windows 上）
2. **完全退出** Claude Desktop（`Cmd+Q` 在 Mac 上，或右键单击任务栏 → 在 Windows 上退出）
3. **重新打开** Claude Desktop
4. 问 Claude：**“您有哪些工具可以使用？”**
5. 您应该看到 **15 个全inTech 工具** 列出！
**完成！** 🎉
---
## 🛠️ 您将获得的工具
### 16 种强大的商业分析工具
#### 高级分析（9 种工具）
1. **query_data** - 灵活的查询，带有过滤器、聚合、排序 + **自动可视化**
2. **get_dashboard_metrics** - 完整的商业仪表盘（收入、支出、盈利能力）
3. **get_revenue_trends** - 按日/周/月/季度显示收入趋势 + **自动可视化**
4. **get_top_customers** - 按收入/生命周期价值/流失风险显示客户排名 + **自动可视化**
5. **get_expense_breakdown** - 按类别显示费用分析，带有百分比 + **自动可视化**
6. **get_project_performance** - 项目分析（预算 vs 实际，利用率）
7. **get_ar_aging** - 应收账龄报告（对现金流至关重要）
8. **get_forecasting** - 收入和现金流预测
9. **search_all_data** - 跨所有数据进行全局关键字搜索
#### 简单数据访问（6 种工具）
10. **get_customers** - 获取所有客户并过滤
11. **get_invoices** - 获取所有发票并过滤
12. **get_projects** - 获取所有项目并过滤
13. **get_time_entries** - 按项目/用户/日期获取时间条目
14. **get_expenses** - 获取费用并按类别/状态
15. **get_cash_flow** - 综合现金流分析
#### 多级钻深（1 种工具） ⭐ NEW！
16. **drill_down** - 多级钻深以进行深入分析 + **自动可视化与点击处理**
- 钻路径：`by_customer`、`by_project`、`by_time`、`by_category`、`by_industry`
- 支持递归钻深（例如，客户 → 项目 → 时间条目）
- 交互式 HTML 可视化与钻深点击处理
- 所有 6 种图表类型可用（条形图、线形图、饼图、甜圈图、雷达图、极坐标图）
### 演示数据可用
- **100 个客户** 跨 15 个行业）
- **1000 张发票**（2023-2027）
- **300 个项目**，带有预算跟踪
- **1211 条时间条目**（可计费/不可计费）
- **300 笔费用**，跨 8 个类别
- **总计：2,411 行**商业数据
---
## 💬 向 Claude 提问的示例
设置完成后，尝试提问：
### 📊 业务概述和仪表盘
- “显示我本月的完整商业仪表盘”
- “本季度我的总收入和利润是多少？”
- “给我一个所有活跃项目的摘要”
- “显示带有钻深选项的商业指标概览”
### 📈 收入分析
- “过去 6 个月的收入趋势如何？”
- “按客户显示本年的收入”
- “创建 2024 年每月收入图表”
- “哪个月的收入最高？”
- “比较 Q1 和 Q2 的收入”
### 👥 客户洞察
- “显示我收入最高的 10 个客户”
- “哪些客户有流失风险？”
- “列出技术行业的所有客户”
- “显示客户生命周期价值排名”
- “哪些客户最近没有收到发票？”
### 💰 现金流管理
- “我的应收账龄报告是什么？”
- “显示所有逾期发票”
- “未来 30 天我将收到多少钱？”
- “我当前的现金流状况如何？”
- “显示未付金额按年龄段划分”
### 📊 项目跟踪
- “哪些项目超出预算？”
- “显示项目绩效与预算 vs 实际”
- “列出所有项目及其完成状态”
- “所有项目中利用率是多少？”
- “按项目显示可计费 vs 不可计费小时数”
### 🔮 预测
- “预测未来 3 个月的收入”
- “下一季度我的预期现金流是多少？”
- “基于历史数据，我应该期待下个月发生什么？”
### 💡 多级钻深查询（新！）
**场景 1：收入深度分析**
- “显示收入按客户划分，然后钻取到收入最高的客户的项目”
- “给我一个行业分类，然后显示技术行业中排名靠前的客户”
- “显示每月收入趋势，然后钻取到按客户划分的最高月份”
**场景 卷积分析**
- “显示按类别划分的费用，然后钻入按月份划分的薪水”
- “分解我的费用按类别，并显示时间趋势”
- “哪些费用类别正在逐月增长？”
**场景 3：客户到项目分析**
- “显示我的最佳客户，然后钻取到他们的项目和时间条目”
- “对于我的最大客户，显示所有项目和哪些项目超出预算”
- “显示客户收入，然后显示他们的项目绩效”
**场景 4：基于时间的分析**
- “显示按月份划分的收入，然后按客户钻取到每个月份”
- “给我一个季度趋势，然后按行业钻取到 Q2”
- “显示按月份划分的费用，然后分解最高月份按类别划分”
**场景 5：行业表现**
- “显示收入按行业划分，然后钻取到最佳行业的客户”
- “哪些行业最赚钱？显示其最佳项目”
- “比较行业表现并钻取到最佳表现行业”
### 🔍 灵活的查询示例
**复杂筛选**
- “显示医疗保健行业所有逾期发票”
- “列出 2024 年 1 月后启动且超出预算的项目”
- “查找所有未计费的计费时间条目”
**聚合**
- “技术客户的总收入是多少？”
- “按行业计算平均项目预算”
- “汇总 2024 年所有营销类别的费用”
**搜索与发现**
- “搜索与‘Johnson’相关的任何内容”
- “查找包含‘咨询’的所有数据”
- “显示与项目 ID 42 相关的所有内容”
**查看 510+ 个更多示例查询的完整文档！**
---
## 🔧 故障排除
### 问题： “MCP allintech：服务器断开连接”
**解决方案**：检查配置文件中的路径是否正确。
**在 Mac 上：**
```bash
# 导航到保存文件的位置
cd ~/allintech-mcp
# 获取完整路径
pwd
```
使用此路径 + `/stdio_client.py` 在您的配置中。
**在 Windows 上：**
打开保存 `stdio_client.py` 的文件夹，点击地址栏，然后复制完整路径。
### 问题：Claude 看不到任何工具
**检查清单：**
1. ✅ Claude Desktop **完全重启**？（不是简单地最小化）
2. ✅ 配置文件 **保存**？（`Cmd+S` 或 `Ctrl+S`）
3. ✅ **Python 3** 安装？运行 `python3 --version`（Mac）或 `python --version`（Windows）
4. ✅ **httpx** 安装？运行 `pip3 install httpx`（Mac）或 `pip install httpx`（Windows）
5. ✅ 配置文件中的路径是 **绝对** 而不是相对路径吗？
- Mac：以 `/Users/` 开头
- Windows：以 `C:\` 开头
### 问题： “ModuleNotFoundError: No module named 'httpx'”
**解决方案：**
```bash
# Mac/Linux
pip3 install httpx
# Windows
pip install httpx
```
### 问题： “Permission denied” （仅限 Mac/Linux）
**解决方案**：使脚本可执行：
```bash
chmod +x ~/allintech-mcp/stdio_client.py
```
### 问题： “python3: command not found” （Mac）
**解决方案**：安装 Python 3：
```bash
# 首先安装 Homebrew（如果未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 安装 Python
### 仍未解决？
**检查 MCP 服务器是否在线：**
```bash
curl https://allintech-mcp-server-588831597903.us-central1.run.app/health
```
应返回：
```json
{"status": "healthy", "data": {...}, "tools": 15}
```
---
## 📚 附加文档
- **[主要 README](../README.md)** - 项目概述和架构
- **[MCP 服务器文档](../README_MCP_SERVER.md)** - 技术服务器详细信息
- **[510+ 示例查询](../CLAUDE_DESKTOP_QUERIES.md)** - 全面的查询示例
- **[部署指南](../DEPLOYMENT_SUMMARY.md)** - 服务器部署方式
- **[MCP 配置说明](../MCP_CONFIGURATION_EXPLAINED.md)** - 技术深入解析
---
## ❓ 常见问题
### 问：我需要付费使用 Claude 吗？
**答：不需要！** 此功能与 Claude Desktop 的 **免费层** 配合使用。您可以使用所有 15 种工具和完整的数据访问。
### 问：它适用于 claude.ai（网页版）吗？
**答：不可以。** MCP 服务器仅适用于 **Claude Desktop**（桌面应用程序），而不适用于网页版。
### 问：此功能访问哪些数据？
**答：仅演示数据。** 此功能是带有示例商业数据的演示 MCP 服务器。不会访问任何真实或个人数据。
### 问：我的数据安全吗？
**答：是的。** 服务器使用 Google Cloud 中存储的示例/演示数据。`stdio_client.py` 仅转发请求到 MCP 服务器 - 它不收集或存储任何信息。
### 问：我可以使用此功能进行我的业务吗？
**答：这是一个演示。** 要使用真实的商业数据，您需要部署自己的实例并连接到您的数据库。有关详细信息，请参见部署指南。
### 问：使用此功能需要付费吗？
**答：对于您（用户）来说：免费。** 服务器已经部署并公开可用。
### 问：免费和专业/最大设置的 MCP 有什么区别？
**答：**
- **免费：** 需要下载 `stdio_client.py` 并手动配置（约 5 分钟）
- **专业/最大：** 只需在连接器 UI 中添加 URL（约 1 分钟）
- **两者都具有相同的 15 种工具和功能！**
---
## 🤝 支持
- **产品页面：** [https://theallin.tech/product](https://theallin.tech/product) - 详细的 product 信息、定价和企业解决方案
- **GitHub 仓库：** [The-Allin/theallintech-mcp-business-analytics](https://github.com/The-Allin/theallintech-mcp-business-analytics)
- **报告问题：** [GitHub 问题](https://github.com/The-Allin/theallintech-mcp-business-analytics/issues)
- **电子邮件支持：** [contact@theallin.tech](mailto:contact@theallin.tech)
- **服务器状态：** https://allintech-mcp-server-588831597903.us-central1.run.app/health
---
## 📋 要求
### 适用于免费用户：
**⚠️ 必须安装（安装前）：**
1. **Python 3.7+** - 使用 `python3 --version`（Mac）或 `python --version`（Windows）检查
- Mac：使用 Homebrew 安装 (`brew install python3`)
- Windows：从 https://www.python.org/downloads/ 下载
2. **httpx Python 包** - `stdio_client.py` 所需
- 使用以下命令安装：`pip3 install httpx`（Mac）或 `pip install httpx`（Windows）
- 使用以下命令验证：`pip3 show httpx`（Mac）或 `pip show httpx`（Windows）
**然后您需要：**
3. **Claude Desktop**（任意平台）- 从 https://claude.ai/download 下载
4. **此 `stdio_client.py` 文件** - 从我们的 GitHub 仓库下载
### 适用于专业/最大用户：
- **Claude Desktop**（任意平台）
- **仅需如此！** 只需添加连接器 URL（无需 Python 或 httpx）
---
**由 ❤️ 为 Claude Desktop 社区构建**
**服务器状态：** 🟢 在线
**工具总数：** 16（包括多级钻深）
**演示数据行数：** 2,411
**部署：** Google Cloud Run
MCP 配置
以下是此 MCP Server 的配置信息，可直接复制到 Cursor 或其他 MCP 客户端中使用。
mcp.json
连接信息
猜你喜欢
暂无推荐服务器