Files
claude-plugins/gestao/skills/today/SETUP_MCPS.md
Emanuel Almeida 2cb3210962 feat: adiciona 12 plugins Descomplicar ao marketplace
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>
2026-02-07 21:41:24 +00:00

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