AllinTech MCP客户端-将Claude桌面连接到业务分析
✨ 适用于克劳德桌面免费版和PRO/MAX版! ✨
______________________________________________________________________
📚 目录
- 适用于Claude Pro/Max用户(1分钟!) - 克劳德免费用户(5分钟)
______________________________________________________________________
🚀 什么是AllinTech?
使命: 让那些被复杂、分散和昂贵的解决方案抛在后面的中小型企业能够使用企业级人工智能。
我们解决的问题:
- 中小企业每年在7+个断开连接的人工智能工具上花费10000+美元
- 84%的人愿意自动化,但缺乏集成的、负担得起的解决方案
- 75%的中小企业正在试验人工智能,但没有人为他们建造
- 现金流不确定性、运营时间消耗、复杂性过载
我们的解决方案: “商业运营的Shopify”-一个人工智能驱动的平台,以企业软件成本的十分之一取代了7种以上的工具。
______________________________________________________________________
🧠 为什么选择MCP(模型上下文协议)?
什么是MCP? MCP是由Anthropic(Claude AI的制造商)创建的开放标准,它实现了AI助手和业务数据源之间的安全双向连接。
把它想象成: “用于AI集成的USB标准”
为什么它是革命性的:
- 传统人工智能:“我无法访问您的数据。以下是通用建议……”
- 使用MCP:AI实际上可以安全地访问您的真实业务数据
- 结果:在3秒内获得有关您业务的具体答案,而不是通用的回复
我们的技术创新:
- 比传统方法快95%(响应时间为3秒对30秒)
- 每次查询便宜95%(0.03美元对0.50美元)
- 通过流式HTTP传输部署在Google Cloud Run上
- 实时智能自动化,了解您的业务
它如何帮助您:
- 用简单的英语提问:“我下个月的现金流是多少?”
- 使用您的实际数据立即获得答案:不是“如何预测”,而是“您的余额将为60630美元”
- 前瞻性见解:“警告:7月15日现金缺口-立即联系客户ABC”
______________________________________________________________________
📦 你会得到什么:16个强大的工具
此文件夹包含您需要连接的所有内容 克劳德桌面 到 AllinTech MCP服务器 用于强大的业务分析。
______________________________________________________________________
📦 这个文件夹里有什么?
stdio_client.py-您需要的唯一文件(将Claude Desktop连接到我们的MCP服务器)
______________________________________________________________________
🚀 安装指南
适用于Claude Pro/Max用户(1分钟!)💎
您的设置最简单,无需任何文件!
第一步:下载克劳德桌面
- 首选https://claude.ai/download
- 下载并安装 克劳德桌面 适用于您的操作系统
步骤2:添加连接器
- 打开 克劳德桌面
- 首选 设置 → 连接器
- 点击 “添加连接器”
- 输入:
- 名字: AllinTech - 统一资源定位符: https://allintech-mcp-server-588831597903.us-central1.run.app/sse
- 点击 保存
步骤3:重新启动并测试
- 重新启动克劳德桌面 (完全退出并重新打开)
- 问克劳德: “你有什么工具可以使用?”
- 你应该看看 15个AllinTech工具 上市的!
完成! 🎉
______________________________________________________________________
克劳德免费用户(5分钟)
您需要下载此文件并对其进行配置:
步骤1:先决条件-安装Python和所需软件包
⚠️ 重要提示:在继续之前,您必须安装这些:
检查是否安装了Python:
# Mac/Linux
python3 --version
# Windows
python --version如果没有安装Python:
在Mac上:
# Install Homebrew first (if not installed)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# Install Python 3
brew install python3在Windows上:
- 从以下网址下载Python:https://www.python.org/downloads/
- 在安装期间, 检查 “将Python添加到PATH”
- 完成安装
安装httpx包(MCP客户端工作所需):
# Mac/Linux
pip3 install httpx
# Windows
pip install httpx✅ 验证httpx是否已安装:
# Mac/Linux
pip3 show httpx
# Windows
pip show httpx第二步:下载克劳德桌面
- 首选https://claude.ai/download
- 下载并安装 克劳德桌面 适用于您的操作系统
步骤3:下载并设置客户端文件
选项A:直接文件下载(最快-推荐)
在Mac/Linux上:
# Create folder
mkdir -p ~/allintech-mcp
cd ~/allintech-mcp
# Download the stdio_client.py file directly
curl -o stdio_client.py https://raw.githubusercontent.com/The-Allin/theallintech-mcp-business-analytics/main/client/stdio_client.py
# Get full path (copy this for your config!)
echo "Full path: $(pwd)/stdio_client.py"在Windows上:
- 直接下载:点击此处下载→ stdio_client.py
- 右击→ 另存为 → 保存到:
C:\Users\YOUR_USERNAME\allintech-mcp\stdio_client.py
选项B:克隆完整存储库
# Clone the repository
git clone https://github.com/The-Allin/theallintech-mcp-business-analytics.git
cd theallintech-mcp-business-analytics/client
# Get full path
echo "Full path: $(pwd)/stdio_client.py"步骤4:配置Claude桌面配置文件
📍 配置文件的确切位置:
对于Mac:
/Users/YOUR_USERNAME/Library/Application Support/Claude/claude_desktop_config.json对于Windows:
C:\Users\YOUR_USERNAME\AppData\Roaming\Claude\claude_desktop_config.json______________________________________________________________________
🔧 如何打开配置文件:
在Mac上:
- 打开 终端 并运行此命令直接打开配置文件:
open -a TextEdit ~/Library/Application\ Support/Claude/claude_desktop_config.json或 手动:
1. 打开 访达 1. 按 Cmd + Shift + G 1. 粘贴: ~/Library/Application Support/Claude/ 1. 双击 claude_desktop_config.json (在TextEdit中打开)
在Windows上:
- 按
Win + R(打开“运行”对话框) - 类型或粘贴:
%APPDATA%\Claude - 按 进入
- 查找并打开
claude_desktop_config.json随着 记事本
______________________________________________________________________
✏️ 在配置文件中添加什么:
⚠️ CRITICAL-请先阅读以下内容:
- 使用完整路径 从步骤3(输出
echo "Full path: ..."命令) - 不要 手动键入用户名或猜测路径
- 复制粘贴 终端中打印的确切路径
重要: 配置文件必须是有效的JSON。如果文件为空或只有 {},用下面的配置替换所有内容。如果您已经有其他MCP服务器,请添加 allintech 现有部分内 mcpServers 对象。
对于Mac用户:
{
"mcpServers": {
"allintech": {
"command": "python3",
"args": [
"PASTE_YOUR_FULL_PATH_HERE"
]
}
}
}对于Windows用户:
{
"mcpServers": {
"allintech": {
"command": "python",
"args": [
"PASTE_YOUR_FULL_PATH_HERE"
]
}
}
}✅ 正确方式:从终端复制路径
在Mac上:
# You ran this in Step 3:
cd ~/allintech-mcp
echo "Full path: $(pwd)/stdio_client.py"
# Output example:
# Full path: /Users/john/allintech-mcp/stdio_client.py
# ✅ COPY THIS ENTIRE PATH ↑ and paste it in your config!在Windows上:
# Navigate to your folder in File Explorer
# Click the address bar at the top
# Copy the path: C:\Users\john\allintech-mcp
# Add \stdio_client.py at the end
# Result: C:\Users\john\allintech-mcp\stdio_client.py
# ✅ COPY THIS ENTIRE PATH ↑ and paste it in your config!示例-正确配置(Mac):
{
"mcpServers": {
"allintech": {
"command": "python3",
"args": [
"/Users/john/allintech-mcp/stdio_client.py"
]
}
}
}示例-正确配置(Windows):
{
"mcpServers": {
"allintech": {
"command": "python",
"args": [
"C:\\Users\\john\\allintech-mcp\\stdio_client.py"
]
}
}
}🚨 要避免的常见错误:
- ❌ 打字
YOUR_USERNAME字面上 - ❌ 忘记替换占位符文本
- ❌ 使用相对路径,如
~/allintech-mcp/stdio_client.py - ❌ 遗忘
\\Windows上的(双反斜杠) - ❌ 错过了
.py文件扩展名 - ✅ 从步骤3开始,始终使用完全绝对路径
步骤5:重新启动并测试
- 保存 配置文件(
Cmd+S在Mac上,Ctrl+S在Windows上) - 完全退出 克劳德桌面(
Cmd+Q在Mac上,或右键单击任务栏→ 在Windows上退出) - 重新开放 克劳德桌面
- 问克劳德: “你有什么工具可以使用?”
- 你应该看看 15个AllinTech工具 上市的!
完成! 🎉
______________________________________________________________________
🛠️ 所得
16个强大的商业分析工具
高级分析(9个工具)
- 查询数据 -使用过滤器、聚合、排序进行灵活查询+ 自动可视化
- get_dashboard_metrics -完整的业务仪表板(收入、支出、盈利能力)
- get_revenue_trends -按天/周/月/季度划分的收入趋势+ 自动可视化
- 获取top_客户 -按收入/生命周期价值/流失风险对客户进行排名+ 自动可视化
- get_expense_breabreak -按类别和百分比进行的支出分析+ 自动可视化
- get_project_performance -项目分析(预算与实际、利用率)
- 获取_老化 -应收账款账龄报告(对现金流至关重要)
- get_预测 -收入和现金流预测
- search_all_data -在所有数据中进行全局关键字搜索
简单数据访问(6个工具)
- get_客户 -为所有客户提供过滤器
- get_invoices -使用筛选器获取所有发票
- get_项目 -获取所有带有过滤器的项目
- get_time_entrys -按项目/用户/日期获取时间条目
- get_expenses -按类别/状态获取费用
- get_cash_flow -综合现金流分析
多级向下钻(1个工具)⭐ 新
- 钻孔 -多级深入分析+ 带点击手柄的自动视觉调整
- 钻孔路径:
by_customer,by_project,by_time,by_category,by_industry - 支持递归深入分析(例如,客户→ 项目→ 时间条目)
- 带有深入点击处理程序的交互式HTML可视化
- 所有6种图表类型可用(条形图、折线图、饼图、甜甜圈图、雷达图、极化区域图)
演示数据可用
- 100名客户 横跨15个行业
- 500张发票 (2023-2027)
- 300个项目 具有预算跟踪功能
- 1211个时间条目 (可计费/不可计费)
- 300费用 跨越8个类别
- 总计:2411行 真实的商业数据
______________________________________________________________________
💬 问克劳德的示例问题
设置后,尝试询问:
📊 业务概述和仪表板
- “显示我本月的完整业务仪表板”
- “我本季度的总收入和利润是多少?”
- “给我一份所有活动项目的摘要”
- “使用深入选项向我展示我的业务指标概述”
📈 收入分析
- “过去6个月我的收入趋势是什么?”
- “按客户显示今年的收入”
- “创建2024年月度收入图表”
- “哪个月的收入最高?”
- “比较第一季度与第二季度的收入”
👥 客户洞察
- “按收入显示我的前10名客户”
- “哪些客户有流失的风险?”
- “列出技术行业的所有客户”
- “显示客户终身价值排名”
- “哪些客户最近没有收到发票?”
💰 现金流管理
- “我的AR老化报告是什么?”
- “显示所有逾期发票”
- “我预计未来30天会有多少钱?”
- “我目前的现金流状况如何?”
- “按年龄显示未付款项”
📊 项目跟踪
- “哪些项目超出预算?”
- “显示预算与实际的项目绩效”
- “列出所有活动项目及其完成状态”
- “所有项目的利用率是多少?”
- “按项目显示计费小时数与非计费小时数”
🔮 预测
- “预测我未来3个月的收入”
- “我预计下个季度的现金流是多少?”
- “根据历史数据,下个月我应该期待什么?”
💡 多级深入查询(新增!)
场景1:收入深度挖掘
- “按客户显示收入,然后深入了解顶级客户的项目”
- “给我一个行业细分,然后展示技术领域的顶级客户”
- “显示每月收入趋势,然后按客户钻取最高月份”
场景2:费用分析
- “按类别显示支出,然后按月份深入查看工资”
- “按类别细分我的开支,并向我展示随时间推移的趋势”
- “哪些支出类别逐月增长?”
场景3:客户到项目分析
- “向我展示我的顶级客户,然后深入了解他们的项目和时间条目”
- “对于我最大的客户,向我展示他们所有超出预算的项目”
- “显示客户收入,然后显示他们的项目绩效”
场景4:基于时间的分析
- “按月显示收入,然后按客户深入查看每个月”
- “给我季度趋势,然后按行业深入了解第二季度”
- “显示每月支出,然后按类别细分最高月份”
情景5:行业绩效
- “按行业显示收入,然后深入了解顶级行业的客户”
- “哪些行业最赚钱?给我看看他们的顶级项目”
- “比较行业表现,深入了解表现最佳的行业”
🔍 灵活的查询示例
复杂过滤
- “显示医疗保健行业客户的所有逾期发票”
- “列出2024年1月之后开始并超出预算的项目”
- “查找所有尚未开具发票的可计费时间条目”
聚合
- “技术客户的总收入是多少?”
- “按行业计算平均项目预算”
- “汇总2024年营销类别中的所有费用”
搜索与发现
- “搜索与‘约翰逊’有关的任何内容”
- “查找所有包含‘咨询’的数据”
- “显示与项目ID 42相关的所有内容”
请参阅完整文档,了解510+更多示例查询!
______________________________________________________________________
🔧 故障排除
问题:“MCP allintech:服务器已断开连接”
解决方案:检查配置文件中的路径是否正确。
在Mac上:
# Navigate to where you saved the file
cd ~/allintech-mcp
# Get the full path
pwd使用此路径+ /stdio_client.py 在您的配置中。
在Windows上: 打开保存的文件夹 stdio_client.py,单击地址栏,然后复制完整路径。
问题:克劳德没有看到任何工具
检查表:
- ✅ 克劳德桌面 完全重新启动?(不仅仅是最小化)
- ✅ 配置文件 已保存? (
Cmd+S或Ctrl+S) - ✅ Python 3 安装?跑
python3 --version(Mac)或python --version(Windows) - ✅ httpx 安装?跑
pip3 install httpx(Mac)或pip install httpx(Windows) - ✅ 配置中的路径为 绝对的不是相对的?
- Mac:从开始 /Users/ - Windows:从开始 C:\
问题:“ModuleNotFoundError:没有名为'httpx'的模块”
解决方案:
# Mac/Linux
pip3 install httpx
# Windows
pip install httpx问题:“权限被拒绝”(仅限Mac/Linux)
解决方案:使脚本可执行:
chmod +x ~/allintech-mcp/stdio_client.py问题:“python3:找不到命令”(Mac)
解决方案:安装Python 3:
# Install Homebrew first (if not installed)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# Install Python 3
brew install python3仍然不工作?
检查MCP服务器是否联机:
curl https://allintech-mcp-server-588831597903.us-central1.run.app/health应返回:
{"status": "healthy", "data": {...}, "tools": 15}______________________________________________________________________
📚 其他文件
______________________________________________________________________
❓ 常见问题解答
Q: 我需要为克劳德付钱吗?
A: 不! 这适用于Claude Desktop的 免费套餐。您可以获得所有15个工具和完整的数据访问权限。
Q: 它在claude.ai(网络)上有效吗?
A: 没有。 MCP服务器仅适用于 克劳德桌面 (桌面应用程序),而不是网络版本。
Q: 此访问哪些数据?
A: 仅演示数据。 这是一个带有示例业务数据的演示MCP服务器。不会访问任何真实或个人数据。
Q: 我的数据安全吗?
A: 是的。 服务器使用存储在Google Cloud中的示例/演示数据。stdio_client.py仅将请求转发到MCP服务器,它不收集或存储任何信息。
Q: 我可以用它来做自己的生意吗?
A: 这是一个演示。 要使用真实的业务数据,您需要部署自己的实例并将其连接到数据库。有关详细信息,请参阅部署指南。
Q: 使用它要花多少钱?
A: 对于您(用户):0美元。 服务器已部署并可公开访问。
Q: 免费设置和Pro/Max设置有什么区别?
A.
- 自由:需要下载
stdio_client.py手动配置(约5分钟) - Pro/Max:只需在连接器UI中添加URL(约1分钟)
- 两者都有完全相同的15个工具和功能!
______________________________________________________________________
🤝 支持
- 产品页面: https://theallin.tech/product -有关详细的产品信息、定价和企业解决方案
- GitHub存储库: Allin/theallintech mcp业务分析
- 报告问题:
- 电子邮件支持: contact@theallin.tech
- 服务器状态: https://allintech-mcp-server-588831597903.us-central1.run.app/health
______________________________________________________________________
📋 需求
免费用户:
⚠️ 必须具备(安装前安装):
- Python 3.7+ -查看
python3 --version(Mac)或python --version(Windows)
- Mac:通过Homebrew安装(brew install python3) - Windows:从下载https://www.python.org/downloads/
- httpx Python包 -需要stdio_client.py才能工作
- 安装方式: pip3 install httpx (Mac)或 pip install httpx (Windows) - 通过以下方式进行验证: pip3 show httpx (Mac)或 pip show httpx (Windows)
那么你需要: 3\. 克劳德桌面 (任何平台)-从下载https://claude.ai/download 4\. 这 stdio_client.py 文件 -从我们的GitHub仓库下载
对于Pro/Max用户:
- 克劳德桌面 (任何平台)
- 就是这样! 只需添加连接器URL(不需要Python或httpx)
______________________________________________________________________
内置❤️ 克劳德桌面社区
服务器状态: 🟢 在线的 工具总数:16(包括多级钻取) 演示数据行: 2,411 部署:谷歌云运行
