Plugins: automacao, crm-ops, design-media, dev-tools, gestao, infraestrutura, marketing, negocio, perfex-dev, project-manager, wordpress + hello-plugin (existente). Totais: 83 skills, 44 agents, 12 datasets.json Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
186 lines
3.8 KiB
Markdown
186 lines
3.8 KiB
Markdown
---
|
|
title: Setup MCPs para /today
|
|
date: 2025-01-21
|
|
status: activo
|
|
---
|
|
|
|
# Setup MCPs para /today
|
|
|
|
## Estado Actual
|
|
|
|
| MCP | Estado | Notas |
|
|
|-----|--------|-------|
|
|
| desk-crm-v3 | ✅ Activo | Tickets, projectos, tarefas |
|
|
| filesystem | ✅ Activo | Notas Obsidian |
|
|
| memory-supabase | ✅ Activo | Persistência |
|
|
| imap | ✅ Activo | 12 contas email |
|
|
| google-workspace | ⏸️ Opcional | Calendar (se necessário) |
|
|
|
|
---
|
|
|
|
## MCP IMAP (Principal)
|
|
|
|
### Contas Configuradas (12)
|
|
```
|
|
emanuel@descomplicar.pt
|
|
it@descomplicar.pt
|
|
help@descomplicar.pt
|
|
suporte@descomplicar.pt
|
|
contabilidade@descomplicar.pt
|
|
financeiro@descomplicar.pt
|
|
info@descomplicar.pt
|
|
rh@descomplicar.pt
|
|
mkt@descomplicar.pt
|
|
design@descomplicar.pt
|
|
news@descomplicar.pt
|
|
aiktop@descomplicar.pt
|
|
```
|
|
|
|
### Ferramentas Disponíveis
|
|
| Ferramenta | Função |
|
|
|------------|--------|
|
|
| `imap_list_accounts` | Listar contas disponíveis |
|
|
| `imap_list_folders` | Listar pastas de uma conta |
|
|
| `imap_list_emails` | Listar emails de uma pasta |
|
|
| `imap_read_email` | Ler email por UID |
|
|
| `imap_search_emails` | Pesquisar emails |
|
|
| `imap_move_email` | Mover email entre pastas |
|
|
| `imap_delete_email` | Eliminar email |
|
|
|
|
### Acções Automáticas Diárias
|
|
1. **SPAM** → `imap_delete_email`
|
|
2. **Promocionais** → `imap_move_email` para "Promotions"
|
|
3. **Facturas pagas** → Reencaminhar para contabilidade@descomplicar.pt
|
|
4. **Prioritários** → Listar no relatório
|
|
|
|
### Regras de Triagem
|
|
Ver: `config/email-triage-rules.md`
|
|
|
|
---
|
|
|
|
## Google Workspace MCP (Opcional)
|
|
|
|
### Localização
|
|
```
|
|
~/mcp-servers/google_workspace_mcp/
|
|
```
|
|
|
|
### Capacidades
|
|
- **Gmail**: Pesquisa, envio, gestão de emails
|
|
- **Calendar**: Eventos, reuniões, agenda
|
|
- **Drive**: Ficheiros (opcional)
|
|
- **Docs/Sheets**: Documentos (opcional)
|
|
|
|
### Requisitos para Activar
|
|
|
|
1. **Google Cloud Console**
|
|
- Criar projecto ou usar existente
|
|
- Activar Gmail API
|
|
- Activar Calendar API
|
|
- Criar credenciais OAuth (Desktop App)
|
|
|
|
2. **Credenciais necessárias**
|
|
```
|
|
GOOGLE_OAUTH_CLIENT_ID=xxx
|
|
GOOGLE_OAUTH_CLIENT_SECRET=xxx
|
|
USER_GOOGLE_EMAIL=emanuel@descomplicar.pt
|
|
```
|
|
|
|
3. **Ficheiros existentes**
|
|
- `client_secret.json` ✅ Existe
|
|
- `token.json` ✅ Existe
|
|
- `.env` ✅ Existe
|
|
|
|
### Verificar Estado
|
|
|
|
```bash
|
|
cd ~/mcp-servers/google_workspace_mcp
|
|
cat .env
|
|
# Verificar se credenciais estão preenchidas
|
|
```
|
|
|
|
### Adicionar ao Claude settings.json
|
|
|
|
```json
|
|
{
|
|
"mcpServers": {
|
|
"google-workspace": {
|
|
"command": "python",
|
|
"args": ["-m", "workspace_mcp"],
|
|
"cwd": "/home/ealmeida/mcp-servers/google_workspace_mcp",
|
|
"env": {
|
|
"GOOGLE_OAUTH_CLIENT_ID": "...",
|
|
"GOOGLE_OAUTH_CLIENT_SECRET": "...",
|
|
"USER_GOOGLE_EMAIL": "emanuel@descomplicar.pt"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
## Passos para Completar Setup
|
|
|
|
### 1. Verificar credenciais Google
|
|
```bash
|
|
cd ~/mcp-servers/google_workspace_mcp
|
|
cat .env
|
|
cat client_secret.json
|
|
```
|
|
|
|
### 2. Testar MCP localmente
|
|
```bash
|
|
cd ~/mcp-servers/google_workspace_mcp
|
|
source venv/bin/activate
|
|
python -m workspace_mcp --test
|
|
```
|
|
|
|
### 3. Adicionar ao Claude
|
|
Editar `~/.claude/settings.json` com configuração acima.
|
|
|
|
### 4. Reiniciar Claude Code
|
|
```bash
|
|
claude --version
|
|
# Fechar e reabrir
|
|
```
|
|
|
|
### 5. Testar no /today
|
|
```bash
|
|
# Executar /today e verificar se Gmail/Calendar funcionam
|
|
```
|
|
|
|
---
|
|
|
|
## Funcionalidades Quando Activo
|
|
|
|
### Gmail
|
|
- `list_emails` - Listar emails
|
|
- `search_emails` - Pesquisar emails
|
|
- `get_email` - Ver email específico
|
|
- `send_email` - Enviar email
|
|
- `create_draft` - Criar rascunho
|
|
|
|
### Calendar
|
|
- `list_events` - Listar eventos
|
|
- `get_event` - Ver evento
|
|
- `create_event` - Criar evento
|
|
- `update_event` - Actualizar evento
|
|
- `delete_event` - Eliminar evento
|
|
|
|
---
|
|
|
|
## Alternativa: MCP Gmail Dedicado
|
|
|
|
Se preferir usar apenas Gmail (mais leve):
|
|
|
|
```
|
|
~/mcp-servers/mcp-gmail.tar.gz
|
|
```
|
|
|
|
Extrair e configurar separadamente.
|
|
|
|
---
|
|
|
|
**Última actualização**: 2025-01-21
|