# Assistente Pessoal MCP Bridge

Ponte MCP remota entre o ChatGPT e o plugin WordPress **Assistente Pessoal Dashboard v0.2+**.

## Objetivo

Depois de conectada ao ChatGPT como app MCP personalizado, esta ponte permite que uma conversa use ferramentas para:

- listar tarefas;
- ler mudanças incrementais;
- criar tarefas;
- atualizar tarefas;
- marcar uma tarefa como Sim / Não / Parcial;
- registrar observações;
- excluir uma tarefa quando solicitado.

O WordPress continua sendo a **fonte permanente de dados**.

## Arquitetura

ChatGPT
   ↓ MCP
Assistente Pessoal MCP Bridge
   ↓ REST + token
WordPress / Assistente Pessoal Dashboard
   ↓
Banco de tarefas + histórico

## Pré-requisito

Instale primeiro o plugin WordPress:

`assistente-pessoal-dashboard-v0.2.0-sync.zip`

Depois vá em:

**WordPress → Assistente Pessoal → Sincronização**

e gere o token.

## Configuração local

Requer Node.js 20+.

```bash
cp .env.example .env
```

Preencha:

```env
WORDPRESS_API_BASE=https://SEU-SITE.com/wp-json/apd/v1
WORDPRESS_SYNC_TOKEN=apd_SEU_TOKEN
PORT=3000
```

Depois:

```bash
npm install
set -a
source .env
set +a
npm start
```

Teste:

```bash
curl http://localhost:3000/healthz
```

## Docker

```bash
docker build -t assistente-pessoal-mcp .
docker run --rm -p 3000:3000 \
  -e WORDPRESS_API_BASE=https://SEU-SITE.com/wp-json/apd/v1 \
  -e WORDPRESS_SYNC_TOKEN=apd_SEU_TOKEN \
  assistente-pessoal-mcp
```

## Publicação

O ChatGPT precisa alcançar um **servidor MCP remoto**. Portanto, publique este serviço em um host HTTPS, como:

- VPS próprio;
- Render;
- Railway;
- Fly.io;
- Cloud Run;
- serviço equivalente.

O endpoint remoto será:

`https://SEU-BRIDGE.com/mcp`

Não exponha o token do WordPress em código público.

## Ferramentas MCP

### `assistente_health`
Testa WordPress ↔ ponte.

### `listar_tarefas`
Retorna snapshot atual + eventos incrementais.

### `criar_ou_atualizar_tarefa`
Faz upsert pelo `external_id`.

### `atualizar_tarefa`
Altera parcialmente status, observações, datas etc.

### `registrar_resultado_tarefa`
Atalho para:
- Sim
- Não
- Parcial
- percentual
- observações

### `excluir_tarefa`
Exclusão lógica, preservando histórico.

## Como conectar ao ChatGPT

A OpenAI atualmente suporta apps personalizados baseados em MCP. O suporte completo a ações de escrita/alteração está em beta e depende do plano/workspace e das permissões administrativas.

Quando seu ambiente oferecer **Developer mode / Custom MCP app**:

1. publique este servidor em HTTPS;
2. copie a URL `https://SEU-BRIDGE.com/mcp`;
3. abra as configurações de apps/plugins do ChatGPT;
4. habilite modo de desenvolvedor, se disponível;
5. adicione o servidor MCP remoto;
6. revise as ferramentas e permissões de escrita;
7. habilite o app para o workspace/conversa.

Depois, em uma conversa onde o app estiver habilitado, comandos como:

> “Crie uma tarefa para concluir a análise da Vera amanhã.”

podem chamar a ferramenta do WordPress.

E:

> “A Vera ficou parcial. Analisei os documentos, falta o CNIS.”

pode atualizar a tarefa e salvar a observação.

## Importante sobre o Projeto do ChatGPT

O Projeto do ChatGPT não transforma automaticamente toda mensagem em uma chamada de ferramenta.

A forma correta é:

1. habilitar o app MCP na conversa/projeto quando o produto permitir;
2. instruir o assistente a usar a ferramenta sempre que uma fala criar/alterar uma tarefa;
3. consultar as tarefas do WordPress antes de organizar o dia ou a semana.

Assim, o WordPress vira a memória operacional compartilhada.

## Regra sugerida para as Instruções do Projeto

Acrescente às instruções do seu Projeto:

> Quando o app Assistente Pessoal estiver disponível, use-o como fonte de verdade das tarefas. Antes de organizar meu dia ou semana, consulte as tarefas atuais. Sempre que eu criar, alterar, concluir parcialmente, concluir ou cancelar uma tarefa, registre a mudança no Assistente Pessoal. Não crie duplicatas: consulte primeiro as tarefas existentes.

## Segurança

- Nunca coloque `WORDPRESS_SYNC_TOKEN` em JavaScript do navegador.
- Nunca publique `.env`.
- Use HTTPS.
- Regenerar o token do WordPress invalida o anterior.
- Considere configurar `MCP_SHARED_SECRET`.
- Use firewall/rate limiting no host.
- Mantenha WordPress, PHP, Node e dependências atualizados.
- Faça backup do WordPress.

## Observação técnica

O servidor usa MCP via Streamable HTTP e o SDK oficial do Model Context Protocol.

Como o ecossistema MCP evolui rapidamente, valide a versão mais recente do SDK antes de colocar em produção.