使用说明
🚀 保理MCP集成项目
使用模型上下文协议(MCP)机器人与Factorial HR API的完整集成系统。
📁 项目结构
factorial-integration/
├── src/
│ ├── web-interface/ # Interface web moderna
│ ├── collectors/ # Coletores Python existentes
│ └── mcp-robots/ # Robôs MCP (Node.js)
├── robô-coletor-factorial/ # Robô coletor (GET)
├── robô-pusher-factorial/ # Robô pusher (POST/PUT)
├── 04_CONFIGURACOES/ # Configurações e credenciais
├── 06_DOCUMENTACAO/ # Documentação completa
└── docs/ # Documentação técnica
🎯 功能
✅ MCP 机器人
- 收藏机器人 (端口 3001):从 Factorial API 收集数据
- 机器人 Pusher (端口 3002):将数据发送到Factorial API
- 界面Web: http://localhost:3001ehttp://localhost:3002
- 协议:SSE+JSON-RPC
✅ Python教程
- 科尔托大师完整的人力资源数据收集
- 集成连接到 MCP 机器人
- 导出JSON、CSV、报告
🚀 如何使用
1. 启动MCP机器人
# Windows PowerShell
.\start_robos.ps1
# Windows CMD
start_robos.bat
2.Acessar界面Web
- 收藏机器人: http://localhost:3001
- 机器人 Pusher: http://localhost:3002
3. 使用 Python 收藏器
# Teste básico
python test_robos_mcp_correto.py
# Exemplo de integração
python exemplo_integracao_robos.py
# Seu coletor existente
python seu_coletor_existente.py
🔧 配置
1.配置程序API密钥
编辑文件 configuracao_robos.env:
API_KEY_APIKEYAUTH=sua_chave_api_aqui
API_BASE_URL=https://api.eu2.demo.factorial.dev
2. 复制设置
copy configuracao_robos.env robô-coletor-factorial\.env
copy configuracao_robos.env robô-pusher-factorial\.env
📊 收集的数据
- 工作人员完整的个人数据列表
- 假期请求和期限
- 合同类型和版本
- 演出评估与能力
- 培训课程和参与
- 存在工作时间和班次
- 还有更多我…
🌟 下一个功能
分行: feature/web-interface
- []仪表板现代化
- [ ] 实时数据查看
- [ ] 图表和报告
- []接口响应a
分行: feature/api-integration
- []集中API
- []速率限制
- [ ] 高级验证
- []集中日志
分行: feature/automation
- []自动系列
- [ ] 调度任务
- [ ] 通知
- [ ] 与其他系统集成
🤝 贡献
- 分叉 项目
- 创建 一个分支用于您的功能(
git checkout -b feature/AmazingFeature) - 提交 变化(
git commit -m 'Add some AmazingFeature') - 推 a分支(
git push origin feature/AmazingFeature) - 打开 um拉取请求
📝 许可证
这个项目是MIT许可的。查看文件 LICENSE 了解更多详情。
🆘 支持
- 文档:
06_DOCUMENTACAO/ - 问题:作为问题使用GitHub
- 联系方式: [您的电子邮件/联系方式]
开发于❤️ 与Factorial HR高效集成