COPILOT_GUIDE.md•4.2 kB
# VS Code Copilot 與 Notion MCP 整合指南
## 🎯 透過 VS Code Copilot 使用 Notion MCP 伺服器
您的 Notion MCP 伺服器已經準備好與 VS Code Copilot 整合！以下是設定和使用指南：
## 📋 前置需求
1. ✅ **VS Code** - 已安裝
2. ✅ **GitHub Copilot 擴充功能** - 需要安裝並啟用
3. ✅ **MCP 支援** - 需要支援 MCP 的 Copilot 版本或相關擴充功能
4. ✅ **Notion MCP 伺服器** - 已建置完成
## 🔧 設定步驟
### 1. 確認 MCP 配置檔案
您的 `.vscode/mcp.json` 已設定：
```json
{
"servers": {
"notion-mcp-server": {
"type": "stdio",
"command": "npm",
"args": ["run", "dev"]
}
}
}
```
### 2. 啟動 MCP 伺服器
在終端機中執行：
```bash
npm run dev
```
伺服器應該顯示：`Notion MCP server running on stdio`
### 3. 在 VS Code 中使用
如果您有支援 MCP 的 Copilot 版本，您可以：
#### 📄 建立新 Notion 頁面
```
@mcp 在我的 Notion 中建立一個新頁面，標題是「今日會議記錄」
```
#### 🔍 搜尋 Notion 頁面
```
@mcp 搜尋我的 Notion 中包含「專案計畫」的頁面
```
#### 📊 查詢資料庫
```
@mcp 查詢我的 Notion 任務資料庫，顯示所有未完成的項目
```
## 🛠️ 可用的 MCP 工具
### 1. `get-page` - 取得頁面
```json
{
"pageId": "your-page-id"
}
```
### 2. `search-pages` - 搜尋頁面
```json
{
"query": "會議記錄",
"filter": {
"property": "Status",
"value": "Active"
}
}
```
### 3. `create-page` - 建立頁面
```json
{
"parent": {
"page_id": "parent-page-id"
},
"properties": {
"title": {
"title": [
{
"text": {
"content": "新頁面標題"
}
}
]
}
},
"children": [
{
"object": "block",
"type": "paragraph",
"paragraph": {
"rich_text": [
{
"type": "text",
"text": {
"content": "這是頁面內容"
}
}
]
}
}
]
}
```
### 4. `update-page` - 更新頁面
```json
{
"pageId": "page-to-update",
"properties": {
"title": {
"title": [
{
"text": {
"content": "更新後的標題"
}
}
]
}
}
}
```
### 5. `query-database` - 查詢資料庫
```json
{
"databaseId": "your-database-id",
"filter": {
"property": "Status",
"select": {
"equals": "In Progress"
}
},
"sorts": [
{
"property": "Created",
"direction": "descending"
}
]
}
```
## 🔍 可用的資源
### 1. 最近頁面
- URI: `notion://recent-pages`
- 描述: 取得最近存取的 Notion 頁面
### 2. 資料庫清單
- URI: `notion://databases`
- 描述: 取得可存取的 Notion 資料庫清單
## 💡 使用範例
### 建立會議記錄頁面
```
@mcp 使用 create-page 工具建立一個新的會議記錄頁面：
- 標題：「2024年7月30日 專案會議」
- 內容包含：會議時間、參與者、討論要點的段落
```
### 搜尋相關頁面
```
@mcp 使用 search-pages 工具搜尋包含「API 文件」的頁面
```
### 查詢任務資料庫
```
@mcp 使用 query-database 工具查詢任務資料庫中狀態為「進行中」的所有項目
```
## 🐛 故障排除
### 如果 Copilot 無法連接到 MCP 伺服器：
1. **檢查伺服器狀態**：
```bash
npm run dev
```
2. **檢查環境變數**：
確認 `.env` 檔案中的 `NOTION_TOKEN` 正確
3. **檢查 Notion 權限**：
確認您的 Notion 整合有適當權限
4. **重新啟動 VS Code**：
有時需要重新啟動 VS Code 來載入 MCP 配置
### 如果您的 Copilot 版本不支援 MCP：
您可以：
1. 等待 GitHub Copilot 官方支援 MCP
2. 使用其他支援 MCP 的 AI 工具
3. 直接透過命令列測試 MCP 伺服器：
```bash
npm test
```
## 📚 更多資源
- [Model Context Protocol 官方文件](https://modelcontextprotocol.io/)
- [Notion API 文件](https://developers.notion.com/)
- [GitHub Copilot 文件](https://docs.github.com/en/copilot)
---
🎉 **現在您可以透過 VS Code Copilot 操作 Notion 了！**