orbit-mcp-server

Servidor MCP remoto que conecta o app Orbit (o painel de tarefas que você vai gerar no Lovable) ao Claude. Com ele publicado e conectado, eu passo a poder criar, listar, atualizar, mudar o status e concluir suas tarefas diretamente, em qualquer conversa.

Como as peças se encaixam

Você  ──(pede no chat)──▶  Claude
                              │
                              │  chama ferramentas MCP (create_task, list_tasks, ...)
                              ▼
                    orbit-mcp-server (este projeto)
                              │
                              │  chama a API REST do Orbit (Bearer token)
                              ▼
                 App Orbit no Lovable + Supabase
                 (Edge Functions /tasks, /categories)
                              │
                              ▼
                   Banco de tarefas + Web Push
                  (notificações no Chrome desktop/mobile)

Related MCP server: Oscribble MCP Server

Passo a passo

1. Gerar o app Orbit no Lovable

1. Acesse lovable.dev e crie um novo projeto.

2. Cole o conteúdo de prompt-lovable-orbit.md (arquivo enviado junto) na caixa de prompt.

3. Deixe o Lovable gerar o projeto e conectar o Supabase (ele guia esse passo).

4. Depois de gerado, confira se o arquivo API.md foi criado no projeto com os endpoints /tasks e /categories — é a documentação que você vai usar no passo 3.

5. No painel do Supabase do projeto, defina o secret API_TOKEN (ou nome equivalente que o Lovable tiver usado) — essa é a string que a API vai exigir no header Authorization: Bearer <token>. Guarde esse valor.

6. Anote a URL base das Edge Functions do seu projeto Supabase (algo como https://SEU-PROJETO.functions.supabase.co).

2. Rodar este servidor localmente (opcional, para testar)

cd orbit-mcp-server
cp .env.example .env
# preencha ORBIT_API_BASE_URL, ORBIT_API_TOKEN e MCP_SHARED_SECRET no .env
npm install
npm run dev

O servidor sobe em http://localhost:3000, com o endpoint MCP em POST /mcp e um health-check em GET /health.

3. Publicar o servidor (para o Claude conseguir acessá-lo pela internet)

Este é um servidor Node/Express comum — qualquer host que rode Node serve. Sugestões simples e com plano gratuito:

• Railway (railway.app): "New Project" → "Deploy from GitHub repo" (suba esta pasta para um repositório) → configure as 3 variáveis de ambiente (ORBIT_API_BASE_URL, ORBIT_API_TOKEN, MCP_SHARED_SECRET) em Settings → Variables → deploy.

• Render (render.com): "New Web Service" apontando para o repositório, build command npm install && npm run build, start command npm start, e as mesmas variáveis de ambiente.

• Fly.io: fly launch na pasta do projeto e fly secrets set ORBIT_API_BASE_URL=... ORBIT_API_TOKEN=... MCP_SHARED_SECRET=....

Depois do deploy, você terá uma URL pública, por exemplo https://orbit-mcp-server.up.railway.app. O endpoint MCP completo é essa URL + /mcp, ex: https://orbit-mcp-server.up.railway.app/mcp.

4. Conectar este servidor ao Claude

No Claude (claude.ai → Configurações → Connectors, ou no Claude Desktop/Cowork em Conectores personalizados):

1. Adicione um Custom Connector (MCP remoto via HTTP).

2. URL: https://SEU-DEPLOY/mcp

3. Header de autenticação: Authorization: Bearer <o mesmo valor de MCP_SHARED_SECRET>

4. Salve e ative o conector.

A partir daí, basta me pedir no chat: "crie uma tarefa no Aviva para revisar o contrato até sexta", "marca a tarefa X como concluída", "lista minhas tarefas urgentes do BETS" — e eu uso as ferramentas create_task, list_tasks, change_task_status, complete_task, update_task e delete_task deste servidor.

Ferramentas MCP expostas

Segurança

• O endpoint /mcp exige o header Authorization: Bearer <MCP_SHARED_SECRET> — sem isso, os pedidos são recusados com 401.

• O servidor nunca guarda suas tarefas — ele só repassa chamadas para a API do seu próprio projeto Supabase, autenticado com ORBIT_API_TOKEN.

• Troque MCP_SHARED_SECRET e ORBIT_API_TOKEN por strings longas e aleatórias (ex: openssl rand -hex 32).