使用说明

自动化项目归档员

使用AI驱动的自动化将Google Drive文档与GitHub存储库连接起来

由Claude Desktop提供支持的智能助手，可将Google Drive中的计划文档与GitHub上的代码库无缝连接，实现自动化工作流程和文档同步。

🌟 概述

自动化项目归档程序使您能够：

阅读和搜索 Google Drive文档和文件夹
管理GitHub存储库 API完全访问
自动化工作流程 在文档和代码之间
生成文档 来自规划文件
同步信息 跨平台

是什么让这个特别？

您可以要求Claude：

“从Google Drive阅读我的项目规范，并在我的GitHub仓库中创建README”
“根据最新的Drive文档更新GitHub文档”
“在Drive中搜索第三季度演示文稿，并在GitHub中创建摘要”

🚀 快速开始

最简单的方法（5分钟）：

安装 Claude 桌面版
打开克劳德桌面→ 设置→ 连接器→ 连接谷歌云端硬盘
在新的聊天中，问：“你能访问我的GitHub存储库吗？”
在收到提示时授权Claude
完成！开始自动化。

🔐 GitHub身份验证方法

连接GitHub的两种方法

方法1:OAuth（内置）-推荐 ✅

何时使用：

你想要最简单的设置
您正在以交互方式使用Claude Desktop
您不需要程序化/自动化访问

赞成的意见：

⚡ 超快速设置（30秒）
🔒 基于浏览器的安全身份验证
🎯 没有要管理的配置文件
✨ Just works™

它是如何工作的： 只需问Claude：“你能访问我的GitHub存储库吗？”然后在出现的弹出窗口中单击授权。

方法2:MCP服务器（高级） ⚙️

何时使用：

您需要程序化访问权限
您正在构建自动化工作流程
您需要持久身份验证
您正在非交互式环境中使用Claude

赞成的意见：

🤖 全自动化支持
💻 适用于无头/服务器环境
🔧 更多权限控制
📝 基于配置的身份验证

欺骗：

⏱️ 更复杂的设置
🔑 需要管理访问令牌
📁 配置文件维护

⚙️ 先决条件

所需软件

Claude 桌面版
- 下载： https://claude.ai/download
- 安装桌面应用程序（不仅仅是web版本）
- 使用您的Anthropic帐户登录
Node.js （仅适用于MCP方法）
- 下载： https://nodejs.org （LTS版本）
- 需要运行GitHub MCP服务器
- 验证安装： node --version 在命令提示符中
账户
- 具有Drive访问权限的Google帐户
- GitHub账号

🛠️ 安装说明

1.谷歌云端硬盘设置

Claude Desktop有一个内置的Google Drive连接器，不需要配置文件！

步骤：

打开克劳德桌面
- 启动桌面应用程序（而不是浏览器）
导航到“设置”
- 点击左上角的汉堡菜单（☰）
- 点击设置
连接谷歌云端硬盘
- 点击 连接器 在左侧边栏中
- 找到 Google 云端硬盘 在顶端
- 点击连接按钮
验证
- 浏览器窗口将打开
- 使用您的Google帐户登录
- 授予请求的权限
- 等待确认
验证
- 返回克劳德桌面
- 你应该看看 “谷歌云端硬盘-已连接” 蓝色的

✅ Google Drive现已连接！

2.GitHub设置（OAuth-推荐）

连接GitHub最简单的方法-需要30秒！

步骤：

打开克劳德桌面
开始新的聊天
问克劳德：
```
Can you access my GitHub repositories?
```
在弹出窗口中授权
- 克劳德会提示你进行身份验证
- 浏览器窗口将打开
- 登录 GitHub
- 点击授权当系统提示时
- 授予请求的权限
完成！
- Claude现在可以访问您的GitHub存储库
- 尝试：“列出我的GitHub存储库”

就是这样！ 没有配置文件，没有令牌，没有复杂性。

3.GitHub设置（MCP-高级）

适用于需要程序化访问的高级用户

第一步：安装Node.js

下载自 https://nodejs.org （LTS版本）
安装并重新启动计算机
验证：打开命令提示符并键入 node --version

步骤2：创建GitHub个人访问令牌

转到令牌设置
- 访问： https://github.com/settings/tokens
生成新令牌
- 点击 “生成新令牌（经典）”
- 注：输入“Claude MCP代理”
- 到期： 选择“90天”（推荐）或“无过期”
选择权限
- ✅ 检查 repo （完全控制私有存储库）
- ✅ 检查 read:user （可选，但推荐）
生成并保存
- 点击 “生成令牌”
- 重要： 立即复制令牌（以开头 ghp_)
- 安全地保存它——你不会再看到它了！

步骤3：配置MCP服务器

查找配置目录
- 按 Windows键+R
- 类型： %APPDATA%\Claude
- 按进入
创建配置文件 （如果不存在）
- 在文件夹中单击鼠标右键
- 选择 New → 文本文档
- 命名它： claude_desktop_config.json
- 关键： 删除 .txt 扩展
编辑配置文件
- 右击 claude_desktop_config.json
- 选择 “用记事本打开”
- 删除所有内容
- 粘贴此配置：

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "PASTE_YOUR_TOKEN_HERE"
      }
    }
  }
}

添加您的令牌
- 替换 PASTE_YOUR_TOKEN_HERE 用你的真实代币
- 保留报价： "ghp_ABCDefgh123..."
- 保存（Ctrl+S）并关闭

步骤4:重新启动克劳德桌面

关键： 更改需要完全重新启动才能生效。

关闭所有克劳德桌面窗口
打开任务管理器（Ctrl+Shift+Esc）
结束任何“克劳德”进程
等待10秒
重新打开克劳德桌面

步骤5：验证MCP服务器

首选 设置→ 开发者
看 “本地MCP服务器”
您应该看到： GitHub -“奔跑”（蓝色徽章）

✅ 测试您的设置

测试谷歌云端硬盘

在Claude Desktop中，键入：

List my files in Google Drive

预期： Claude将搜索并显示您的Google Drive文件。

测试GitHub

在新聊天中，键入：

List my GitHub repositories

预期： Claude将列出您的GitHub存储库。

测试集成

尝试组合任务：

Search my Google Drive for "project_plan.doc" and create a 
README.md file in my GitHub repository "my-project" based on it

💡 使用示例

示例1：文档到代码

Read the project specifications from my Google Drive document 
"Product_Requirements.docx" and create a README.md file in my 
GitHub repository "new-product"

示例2：文档同步

Find the latest meeting notes in my Google Drive folder "Team Meetings" 
and update the CHANGELOG.md in my GitHub repo "company-app"

示例3：自动报告

Search my Google Drive for the Q4 financial presentation, 
summarize it, and create a new file called SUMMARY.md in 
my GitHub repository "company-reports"

示例4：架构文档

Read the system architecture document from Google Drive folder 
"Technical Docs" and generate a mermaid diagram in the GitHub 
repository "platform-docs"

示例5：发行说明生成

Look at my Google Drive document "Feature_List.doc" and create 
comprehensive release notes in my GitHub repository as 
"release_notes.md"

🔧 故障排除

Google Drive问题

问题：“找到0个结果”

可能的原因：

清空Google云端硬盘
连接了错误的Google帐户

解决方案：

转到“设置”→ 连接器
点击“谷歌云端硬盘”旁边的三个点（⋯）
检查连接了哪个帐户
必要时断开连接并重新连接

GitHub OAuth问题

问题：未出现授权弹出窗口

解决：

检查浏览器中的弹出窗口是否被阻止
再问一次：“你能访问我的GitHub吗？”
重新启动克劳德桌面

问题：“拒绝访问”错误

解决：

首选 GitHub设置→ 应用程序
在列表中找到“克劳德”
点击“撤销访问”
再次尝试授权

GitHub MCP问题

问题：“无效令牌”错误

解决：

令牌可能已过期或不正确
生成新令牌
使用新令牌更新配置文件
重新启动克劳德桌面

问题：“找不到命令”错误

解决：

Node.js未安装或未在PATH中
重新安装Node.js
重启电脑
通过以下方式进行验证： node --version

问题：MCP服务器显示“失败”

解决：

转到“设置”→ 开发者
检查错误消息
验证配置文件中的JSON语法
使用 Jsonlint 验证
确保文件位置正确： %APPDATA%\Claude\claude_desktop_config.json

一般问题

问题：配置文件未加载

检查表：

✅ 文件位置： %APPDATA%\Claude\claude_desktop_config.json
✅ 不在子文件夹中
✅ 确切的文件名（不是 .json.txt)
✅ 有效的JSON语法
✅ Claude Desktop已完全重新启动

🔒 安全最佳实践

关键安全规则

永远不要分享你的GitHub代币
- 将其视为密码
- 不要提交到存储库
- 不包括在屏幕截图中
- 不要将配置文件上传到云存储或聊天应用程序
令牌到期
- 使用30-90天过期（不是“无过期”）
- 设置日历提醒以重新生成
- 每月审核活动代币 GitHub代币
最低权限
- 仅授予必要的范围
- 仔细审查权限请求
- 尽可能使用只读
配置文件保护
- 保持备份加密
- 增添 .gitignore 如果备份
- 从不分享或上传
定期审计
- 每月查看GitHub令牌列表
- 删除未使用的令牌
- 检查可疑活动
- 监控GitHub安全警报

如果你的代币被盗

妥协的迹象：

意外的提交或更改
您没有创建的新存储库
GitHub安全警报
异常活动通知

立即行动：

首选 GitHub设置→ 代币
点击受损令牌上的“删除”或“撤销”
回顾最近的活动： GitHub安全日志
生成新令牌
使用新令牌更新配置文件
启用2FA（如果尚未激活）

🤔 常见问题

一般问题

Q： OAuth和MCP身份验证有什么区别？

A： OAuth更简单，建议交互式使用。MCP用于高级自动化和程序化访问。大多数用户应该使用OAuth。

Q：我可以同时使用这两种身份验证方法吗？

A：是的，但OAuth将优先用于交互式使用。MCP对于自动化脚本很有用。

Q：这适用于Mac还是Linux？

A：是的！配置文件位置不同：

雨衣： ~/Library/Application Support/Claude/claude_desktop_config.json
Linux： ~/.config/Claude/claude_desktop_config.json

Q：我可以使用多个Google帐户吗？

A：一次只能连接一个Google帐户。在“设置”中切换、断开连接和重新连接其他帐户→ 连接器。

Q：如果使用OAuth，我需要Node.js吗？

A：不！Node.js只需要MCP方法。OAuth无需任何额外软件即可工作。

GitHub问题

Q：我的GitHub代币会过期吗？

A：这取决于你的设置。我们建议90天的安全期限。到期后，您需要重新生成。

Q：我可以随时撤销访问权限吗？

A：是的！首选 GitHub设置→ 应用程序并撤销克劳德的访问权限。

Q： Claude需要什么权限？

A：对于MCP： repo （存储库访问）和可选 read:user对于OAuth：在授权过程中请求权限。

Q：有人可以用我的令牌访问我的repos吗？

A：是的！持有您的令牌的任何人都有您授予的相同访问权限。这就是为什么安全至关重要。

Google Drive问题

Q： Claude可以访问哪些文件？

A： Claude可以访问您连接的Google云端硬盘中的所有文件，包括文档、工作表和PDF。

Q：克劳德会修改我的驱动器文件吗？

A：目前，克劳德对谷歌云端硬盘拥有只读访问权限。它可以读取但不能修改您的文件。

Q：我可以限制Claude访问哪些文件夹吗？

A：不，连接器可以访问整个驱动器。仅当您对此感到满意时，才授予访问权限。

故障排除问题

Q：为什么GitHub连接不起作用？

A：首先尝试OAuth方法，询问“你能访问我的GitHub吗？”如果失败，请检查GitHub的状态页面和你的互联网连接。

Q：我的配置文件未加载。我该怎么办？

A：验证：

正确的位置(%APPDATA%\Claude\claude_desktop_config.json)
有效的JSON（使用jsonline.Com）
不 .txt 扩展
Claude完全重新启动（结束任务管理器中的进程）

Q：我不小心分享了我的代币。现在怎么办？

A：立即：

转到GitHub→ 设置→ 代币
撤销已暴露的令牌
生成一个新的
更新配置文件
检查GitHub安全日志中的可疑活动

📚 资源

官方文件

安全资源

📝 更新日志

版本1.1（2026年1月）

添加了OAuth身份验证方法（推荐）
增强的安全文档
添加了全面的常见问题解答部分
扩展使用示例
改进的故障排除指南

版本1.0（2026年1月）

初始版本
Google Drive连接器设置
GitHub MCP服务器配置
基本文档和示例

🎯 你能建造什么

使用自动化项目归档程序，您可以创建：

✅ 自动化文档管道

同步计划文档→ GitHub自述
根据会议记录更新变更日志
根据规范生成API文档

✅ 项目管理自动化

从Drive任务列表中创建GitHub问题
从驱动器报告中更新项目状态
从功能文档生成发行说明

✅ 知识库同步

使用Drive内容更新Wiki
从演示文稿创建文档
将重要文件归档到仓库

✅ 工作流程自动化

自动化代码文档
CI/CD文档更新
跨平台项目跟踪

🙏 致谢

该项目是使用以下方式构建的：

📄 许可证

本项目配置和文档按原样提供，用于教育和生产力目的。

🤝 贡献

是否有改进或发现问题？请随意：

打开一个问题
提交拉取请求
分享您的用例

⚠️ 重要说明

OAuth与MCP决策指南

在以下情况下选择OAuth：

✅ 你想要最简单的设置
✅ 您正在以交互方式使用Claude Desktop
✅ 您不需要自动化脚本
✅ 你想要基于浏览器的安全性

在以下情况下选择MCP：

✅ 您需要程序化访问权限
✅ 您正在构建自动化工作流程
✅ 您对配置文件很熟悉
✅ 您需要持久身份验证

大多数用户应该从OAuth开始 并且只有在需要高级功能时才移动到MCP。

🌟 成功标准

在以下情况下，您将知道一切正常：

✅ 在设置中→ 连接器：

谷歌云端硬盘显示“已连接”（蓝色文本）

✅ 对于OAuth：

你可以问“列出我的GitHub存储库”并查看你的存储库

✅ 对于MCP（设置→ 开发商）：

github用蓝色徽章显示“跑步”
无错误消息

✅ 集成测试工作：

“阅读我的Drive文档并创建GitHub文件”成功

🎉 祝贺

您已成功设置自动项目归档程序！

现在，您有了一个人工智能助手，可以将您的Google Drive文档与GitHub存储库连接起来，实现强大的自动化工作流程。

记得： 安全是一种持续的做法。定期检查您的令牌、权限和访问日志，以确保存储库和文档的安全。

自动化快乐！ 🚀

最后更新日期：2026年1月26日
版本：1.1
平台：Windows 10/11、macOS、Linux
由Claude Desktop提供技术支持

使用说明

自动化项目归档员

🌟 概述

是什么让这个特别？

📋 目录

🚀 快速开始

🔐 GitHub身份验证方法

连接GitHub的两种方法

方法1:OAuth（内置）-推荐 ✅

方法2:MCP服务器（高级） ⚙️

⚙️ 先决条件

所需软件

🛠️ 安装说明

1.谷歌云端硬盘设置

2.GitHub设置（OAuth-推荐）

步骤：

3.GitHub设置（MCP-高级）

第一步：安装Node.js

步骤2：创建GitHub个人访问令牌

步骤3：配置MCP服务器

步骤4:重新启动克劳德桌面

步骤5：验证MCP服务器

✅ 测试您的设置

测试谷歌云端硬盘

测试GitHub

测试集成

💡 使用示例

示例1：文档到代码

示例2：文档同步

示例3：自动报告

示例4：架构文档

示例5：发行说明生成

🔧 故障排除

Google Drive问题

问题：“找到0个结果”

GitHub OAuth问题

问题：未出现授权弹出窗口

问题：“拒绝访问”错误

GitHub MCP问题

问题：“无效令牌”错误

问题：“找不到命令”错误

问题：MCP服务器显示“失败”

一般问题

问题：配置文件未加载

🔒 安全最佳实践

关键安全规则

如果你的代币被盗

🤔 常见问题

一般问题

GitHub问题

Google Drive问题

故障排除问题

📚 资源

官方文件

安全资源

📝 更新日志

版本1.1（2026年1月）

版本1.0（2026年1月）

🎯 你能建造什么

🙏 致谢

📄 许可证

🤝 贡献

⚠️ 重要说明

OAuth与MCP决策指南

🌟 成功标准

🎉 祝贺

相关 MCP

Git MCP 服务器

AI助手协议服务器

AI任务管理系统

GitHub MCP服务器

智能代理编排平台

媒体管理协议服务器