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+.

cp .env.example .env

Preencha:

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

Depois:

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

Teste:

curl http://localhost:3000/healthz

Docker

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.