MCP表
将谷歌表格连接到克劳德桌面
本指南将帮助您设置Claude Desktop和Google表格之间的连接。设置完成后，您可以通过对话让Claude创建电子表格、读取数据、写入数据、格式化单元格等。
______________________________________________________________________
你需要什么
在开始之前，请确保您已经：
- Google帐户
- Claude Desktop已安装在您的计算机上
- Docker桌面已安装并正在运行(点击此处下载)
- 30分钟
______________________________________________________________________
第一步：下载此项目
首先，在您的计算机上获取项目文件。
选项A：下载ZIP
- 点击“下载ZIP”
- 将文件解压缩到您会记住的位置（如“桌面”或“文档”文件夹）
选项B：使用终端（Mac）或命令提示符（Windows）
git clone https://github.com/Shravan1610/Sheets-MCP.git
cd Sheets-MCP______________________________________________________________________
第二步：获取谷歌凭据
你需要告诉谷歌，你的应用程序可以访问你的电子表格。
- 首选 谷歌云控制台
- 创建新项目（或使用现有项目）
- 点击顶部的“选择项目” - 点击“新建项目” - 给它起个名字，比如“我的表格访问”
- 启用Google Sheets API：
- 点击菜单（☰）→“API和服务”→ “图书馆” - 搜索“Google Sheets API” - 点击它并点击“启用”
- 创建OAuth凭据：
- 转到“API和服务”→ “凭据” - 点击“创建凭据”→ “OAuth客户端ID” - 如果询问，请配置同意屏幕： - 用户类型：外部（没关系） - 应用程序名称：随你所需 - 您的用户支持电子邮件 - 保存并继续浏览屏幕 - 返回创建OAuth客户端ID： - 选择“Web应用程序” - 随便叫什么 - 添加授权重定向URI： https://developers.google.com/oauthplayground/ - 点击“创建”
- 下载凭据：
- 您将看到一个包含客户端ID和密码的弹出窗口 - 点击“下载JSON” - 重要提示： 将此文件重命名为 credentials.json - 将其移动到项目文件夹（您在步骤1中下载/克隆的文件夹）
______________________________________________________________________
步骤3：安装项目依赖项
现在，我们将安装所需的软件包。
打开终端（Mac）或命令提示符（Windows）：
雨衣： 按 Command + Space，键入“终端”，然后按Enter键
窗户： 按 Windows Key，键入“cmd”，然后按Enter键
导航到项目文件夹：
替换 path/to 保存项目的实际位置。例如：
- 如果在桌面上：
cd ~/Desktop/Sheets-MCP - 如果在文件中：
cd ~/Documents/Sheets-MCP
cd path/to/Sheets-MCP安装软件包：
npm install你会看到文本滚动——这很正常。等待它完成（您将看到命令提示符返回）。
______________________________________________________________________
第四步：通过谷歌进行身份验证
此步骤将您的Google帐户连接到MCP服务器。
运行此命令：
node auth.js您将看到：
- 一个长URL-复制并粘贴到浏览器中
- 登录谷歌
- 点击“高级”→ “转到\[你的应用程序名称\]（不安全）”（这对个人项目来说很正常）
- 单击“允许”以访问电子表格
- 您将被重定向到一个页面-从URL复制代码（在
code=) - 将其粘贴回终端，上面写着“输入授权码”
如果成功，您将看到“Token保存到Token.json”✅
刚才发生了什么？ 你创造了一个 token.json 该文件允许应用程序安全地访问您的Google表格。
______________________________________________________________________
第五步：用Docker打包一切
现在，我们将把所有内容打包到Claude Desktop可以使用的容器中。
确保Docker桌面正在运行！
- Mac：在顶部的菜单栏中查找Docker whale图标
- Windows：在底部的系统托盘中查找Docker whale图标
如果Docker没有运行，打开Docker桌面并等待它启动。
在您的终端中，运行以下命令：
docker build -t google-sheets-mcp .重要提示： 别忘了经期(.)最后！
第一次需要2-3分钟。你会看到很多文本——这很正常。只需等待它完成。
完成后，您将看到类似以下内容：
Successfully built abc123
Successfully tagged google-sheets-mcp:latest______________________________________________________________________
步骤6：配置Claude桌面
现在，我们将向Claude Desktop介绍您的新Google表格连接。
编辑Claude的配置文件
雨衣：
在终端中，运行：
nano ~/Library/Application\ Support/Claude/claude_desktop_config.json这将在您的终端中打开一个文本编辑器。
窗户：
在命令提示符中，运行：
notepad %APPDATA%\Claude\claude_desktop_config.json这将打开带有配置文件的记事本。
______________________________________________________________________
添加配置
如果文件为空或不存在，粘贴整个内容：
{
"mcpServers": {
"google-sheets": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"google-sheets-mcp:latest"
]
}
}
}如果文件已经有内容，您将看到与列出的其他MCP服务器类似的内容。在这种情况下：
- 查找
"mcpServers": {线 - 在最后一个服务器关闭后添加逗号
} - 在决赛前添加谷歌表格部分
}
添加到现有配置的示例：
{
"mcpServers": {
"some-other-server": {
"command": "..."
},
"google-sheets": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"google-sheets-mcp:latest"
]
}
}
}保存文件：
- Mac（nano）： 按
Control + O那么Enter为了保存，那么Control + X退出 - Windows（记事本）： 单击“文件”→ 保存，然后关闭记事本
______________________________________________________________________
步骤7：重新启动克劳德桌面
这很重要： 您必须完全退出Claude Desktop，而不仅仅是关闭窗口。
雨衣：
- 点击克劳德桌面使其处于活动状态
- 按
Command + Q在键盘上
- 或者右键单击Dock中的Claude图标，然后单击“退出”
窗户：
- 在系统托盘（右下角）中查找克劳德图标
- 右键单击它并选择“退出”
等待5秒，然后再次打开Claude Desktop。
______________________________________________________________________
步骤8：测试您的设置！
在Claude中打开一个新对话，然后问：
"What Google Sheets tools do you have?"你应该看到克劳德用8个工具的列表做出回应：
read_sheet-从单元格读取数据write_sheet-将数据写入单元格append_sheet-在底部添加行create_sheet-创建新选项卡create_spreadsheet-创建一个全新的电子表格get_spreadsheet_info-获取有关电子表格的信息clear_range-清除单元格format_cells-使单元格加粗、着色等。
如果你看到这些工具， 祝贺它正在工作！ 🎉
______________________________________________________________________
如何使用它
快速入门：创建您的第一个电子表格
在Claude中尝试以下命令：
"Create a new spreadsheet called 'My First Sheet' with a tab called 'Data' that has columns: Name, Email, Phone"克劳德将创建电子表格，并给你一个链接！
查找您的电子表格ID
在浏览器中打开任何谷歌表格。URL看起来像：
https://docs.google.com/spreadsheets/d/1ABC123xyz456/edit之间的部分 /d/ 和 /edit 是您的电子表格ID： 1ABC123xyz456
大多数命令都需要此ID。
示例命令
创建新的电子表格：
"Create a new spreadsheet called 'My Budget 2025' with sheets named 'Income', 'Expenses', and 'Summary'"读取数据：
"Read cells A1:D10 from the 'Sales' sheet in spreadsheet 1ABC123xyz"写入数据：
"In spreadsheet 1ABC123xyz, write this to the 'Expenses' sheet starting at A1:
Row 1: Date, Category, Amount, Notes
Row 2: 2025-01-15, Food, 45.50, Groceries"附加数据：
"Add this row to the bottom of the 'Log' sheet in spreadsheet 1ABC123xyz:
2025-01-15, Task completed, John"设置单元格格式：
"Make cells A1:E1 in spreadsheet 1ABC123xyz bold with a blue background"获取电子表格信息：
"Show me all the sheets in spreadsheet 1ABC123xyz"______________________________________________________________________
真实世界的例子
预算跟踪器
"Create a budget tracker spreadsheet called 'Personal Budget 2025' with:
1. 'Income' sheet with columns: Date, Source, Amount
2. 'Expenses' sheet with columns: Date, Category, Amount, Notes
3. 'Summary' sheet for totals
Format all header rows with bold text and gray background"任务管理
"Create a task tracker called 'Project Tasks' with columns:
Task, Priority, Status, Assigned To, Due Date
Add these tasks:
1. Setup database, High, In Progress, Alice, 2025-01-20
2. Design UI, Medium, Not Started, Bob, 2025-01-25
3. Write tests, Low, Not Started, Charlie, 2025-01-30
Format the header row with blue background and white text"销售仪表盘
"Create a sales dashboard called 'Q1 Sales 2025' with:
Sheet 1 - 'Daily Sales':
Columns: Date, Sales Rep, Amount, Product
Sheet 2 - 'Summary':
Columns: Sales Rep, Total Sales, Number of Deals
Format headers with bold text"______________________________________________________________________
故障排除
问题：Claude中没有出现工具
解决方案：
- 检查Docker Desktop是否正在运行（查找whale图标）
- 完全退出克劳德桌面：
- Mac：按 Command + Q - Windows：右键单击系统托盘图标→ Exit
- 等待5秒
- 再次打开克劳德桌面
- 检查你的配置文件没有拼写错误
问题：“未找到令牌”错误
解决方案：
返回项目文件夹中的终端并运行：
node auth.js再次执行身份验证步骤，然后重新生成：
docker build -t google-sheets-mcp .完全重新启动克劳德桌面。
问题：“找不到请求的实体”
此错误意味着：
- 电子表格ID不正确（请检查您是否从URL正确复制了它）
- 您没有访问该电子表格的权限
- 电子表格已删除
问题：Docker构建失败
在使用Docker构建之前，请确保您的项目文件夹中有以下文件：
credentials.json（从步骤2开始）token.json（在步骤4中创建）
通过运行以下命令检查它们是否存在：
ls credentials.json token.json如果缺少其中任何一个，请返回相关步骤。
______________________________________________________________________
最佳结果提示
命令要具体
良好：“从电子表格1ABC123的表1中读取单元格A1:D10” 不太好：“从我的电子表格中读取一些数据”
始终使用电子表格ID
好：“在电子表格1ABC123xyz中…” 不太好：“在我们之前制作的电子表格中……”
分解复杂任务
对于大型项目，请Claude：
- 首先创建电子表格
- 然后添加数据
- 然后格式化标题
- 最后应用颜色
跟踪您的电子表格ID
当Claude创建一个新的电子表格时，它会给你ID。将其保存在某个地方（如注释），以便以后可以轻松使用。
______________________________________________________________________
重要安全信息
将这些文件保密，切勿共享：
credentials.json-包含您的Google OAuth凭据token.json-包含您的访问令牌
这些文件已经设置为被git忽略（in .gitignore)，因此如果您共享此项目，它们将不会被上传。
如果您意外共享这些文件：
- 首选 谷歌云控制台
- 转到“API和服务”→ “凭据”
- 找到您的OAuth 2.0客户端ID并将其删除
- 创建新凭据（重复本指南的步骤2）
- 重新验证（重复本指南的步骤4）
______________________________________________________________________
这能做什么和不能做什么
你能做什么：
- 创建新的电子表格
- 从单元格读取数据
- 将数据写入单元格
- 在工作表底部添加行
- 设置单元格格式（颜色、粗体等）
- 创建新选项卡/工作表
- 清除单元格范围
- 获取有关电子表格的信息
你不能做的事：
- 自动列出所有电子表格
- 删除电子表格
- 与他人共享电子表格
- 更改电子表格权限
- 创建图表或图形
- 运行复杂的公式（尽管您可以将公式文本写入单元格）
______________________________________________________________________
如果出了什么问题
检查表-按顺序逐一检查：
- ✓ Docker桌面正在运行吗？（检查鲸鱼图标）
- ✓ 你有
credentials.json在项目文件夹中？ - ✓ 你有
token.json在项目文件夹中？ - ✓ 你跑了吗
npm install成功？ - ✓ 你跑了吗
docker build -t google-sheets-mcp .成功？ - ✓ 您的Claude配置文件格式是否正确（有效的JSON）？
- ✓ 您是否完全退出并重新启动了Claude Desktop？
全新开始：
如果什么都不起作用，你可以重新开始。在您的终端中：
# Remove old Docker containers and images
docker stop $(docker ps -aq)
docker rmi google-sheets-mcp
# Clean up and reinstall
rm -rf node_modules package-lock.json
npm install
# Re-authenticate
node auth.js
# Rebuild Docker image
docker build -t google-sheets-mcp .然后完全退出并重新启动Claude Desktop。
______________________________________________________________________
你都准备好了！
您现在已将Claude Desktop连接到Google表格！
尝试什么的想法：
- “创建2025年预算跟踪系统”
- 制作一个待办事项列表电子表格，其中包含任务、优先级和状态列
- “创建锻炼追踪器”
- 构建包含姓名、电子邮件和电话列的联系人列表
- “制作一周的用餐计划电子表格”
玩得开心如果你在特定任务上需要帮助，只需在正常对话中询问克劳德——他会知道如何使用这些工具。
______________________________________________________________________
需要帮助？
如果您遇到问题或有疑问，您可以：
- 检查上面的故障排除部分
- 直接询问Claude（这可以帮助排除故障）
- 检查每一步，确保没有遗漏任何内容
记住：最常见的问题是在更改配置文件后忘记完全退出并重新启动Claude Desktop！