Monday.com — 工作流管理

通过托管OAuth集成Monday.com GraphQL API，管理看板、任务、列、分组、用户和工作区。

快速开始

# 获取当前用户信息
python <<'EOF'
import urllib.request, os, json
data = json.dumps({'query': '{ me { id name email } }'}).encode()
req = urllib.request.Request('https://gateway.maton.ai/monday/v2', data=data, method='POST')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Content-Type', 'application/json')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

基础URL

https://gateway.maton.ai/monday/v2

所有请求使用POST方法访问GraphQL端点。网关将请求代理到api.monday.com并自动注入您的OAuth令牌。

认证

所有请求需要在Authorization头中包含Maton API密钥：

Authorization: Bearer $MATON_API_KEY

环境变量：将您的API密钥设置为MATON_API_KEY：

export MATON_API_KEY="YOUR_API_KEY"

获取API密钥

• 登录或创建账户：maton.ai
• 访问：maton.ai/settings
• 复制您的API密钥

连接管理

在https://ctrl.maton.ai管理您的Monday.com OAuth连接。

列出连接

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

常用操作

查询看板

query {
  boards {
    id
    name
    state
  }
}

创建任务

mutation {
  create_item(board_id: 123456, item_name: "新任务") {
    id
    name
  }
}

更新任务

mutation {
  change_simple_column_value(board_id: 123456, item_id: 789012, column_id: "status", value: "完成") {
    id
    name
  }
}

使用场景

• 自动化项目管理流程
• 批量创建和更新任务
• 同步数据到其他系统
• 生成项目报告和仪表板
• 设置自动化工作流

注意事项

• 所有API流量通过Maton网关代理
• 定期检查并撤销不需要的OAuth连接
• 项目数据可能包含敏感商业信息，注意保密