Conecte o Year in Review

Use seus rastreadores no Claude, ChatGPT, Cursor e outras ferramentas de IA compatíveis com MCP. Faça login uma vez com sua conta do Year in Review; tudo o que você fizer pela IA sincroniza com o app instantaneamente.

URL do servidor

https://mcp.yearinreviewapp.com/sse

Cole isto no campo Conector Personalizado de qualquer cliente MCP, ou siga os passos por cliente abaixo.

Instalação por cliente

Claude Desktop (macOS / Windows)

  1. Abra o Claude Desktop → Settings → Developer → Edit Config
  2. Adicione este bloco (mesclando com qualquer mcpServers existente):
{
  "mcpServers": {
    "year-in-review": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.yearinreviewapp.com/sse"
      ]
    }
  }
}
  1. Feche o Claude Desktop completamente (⌘Q) e abra novamente.
  2. Pergunte: “Liste meus rastreadores do Year in Review.” O Claude vai pedir para você fazer login.
O mcp-remote é uma pequena ponte local que gerencia o OAuth automaticamente — o Claude Desktop ainda não fala MCP por HTTP nativamente.

Documentação oficial ↗

Claude (web / iOS / Android)

  1. Abra o Claude → Settings → Connectors → Add Custom Connector
  2. Cole a URL do servidor acima e siga as instruções de OAuth.
  3. Uma vez conectado, o conector aparece em All connectors em todo dispositivo logado na sua conta do Claude.

Documentação oficial ↗

ChatGPT (app para desktop)

  1. App do ChatGPT para desktop → Plugins → MCPs → Add → Add MCP server
  2. Dê o nome que quiser e defina Type como STDIO.
  3. Command to launch: npx
  4. Arguments, um por linha: -y, mcp-remote, https://mcp.yearinreviewapp.com/sse
Somente desktop — os apps móveis do ChatGPT ainda não têm configurações de MCP. No celular, use o Claude.

Documentação oficial ↗

Cursor / Windsurf / Raycast / outros clientes MCP

Aponte qualquer cliente MCP para o servidor via mcp-remote, que cuida do login para você:

{
  "mcpServers": {
    "year-in-review": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.yearinreviewapp.com/sse"
      ]
    }
  }
}

Na primeira execução o navegador abre para você entrar na sua conta do Year in Review. Não precisa de chave de API.

Documentação oficial ↗

Ferramentas disponíveis

O conector expõe 20 ferramentas de leitura e escrita para seus rastreadores. Alguns exemplos do que a IA pode fazer:

As escritas vão pelo seu app em tempo real via sincronização em nuvem, então as edições da IA aparecem instantaneamente no seu celular.

Solução de problemas

Não recebi o email de login

Verifique a caixa de spam ou lixo eletrônico — o remetente é [email protected]. O Supabase limita as solicitações de OTP a uma a cada 60 segundos, então aguarde um minuto antes de pedir de novo. Se o email não chegar em 2–3 minutos, seu provedor pode estar filtrando; tente outro endereço na tela de login.

O link de login abre uma página de “sessão expirada”

Os links mágicos expiram 10 minutos após serem emitidos, e a sessão PKCE associada dura o mesmo tempo. Se você deixou o email aberto por muito tempo, recomece o fluxo no seu cliente MCP (ele emite um novo link).

A IA não encontra meus rastreadores após conectar

Provavelmente você está logado em uma conta do Year in Review diferente da que tem seus rastreadores. Desconecte o conector no seu cliente MCP (Claude → Configurações → Conectores → Desconectar), reconecte e escolha o método de login vinculado à sua conta real.

As chamadas de ferramentas falham com erro de autenticação no meio da conversa

Os tokens de acesso duram uma hora e são renovados automaticamente. Se a renovação falhar (por exemplo depois de longa ociosidade ou troca de senha), seu cliente vai mostrar erro de autenticação na próxima chamada — desconecte e reconecte o conector para emitir um token novo.

Erro de “limite de uso”

Os limites por usuário são 60 chamadas por minuto e 500 por dia. O uso conversacional normal fica bem abaixo disso. Se bater no limite, aguarde 60 segundos e tente de novo.

A tela de consentimento OAuth mostra o nome de cliente errado

Os clientes MCP se registram sozinhos na primeira conexão via Dynamic Client Registration, então o nome reflete o que o cliente enviou (por exemplo “Claude”, “ChatGPT” ou o rótulo padrão do cliente). Isso não afeta permissões — você continua se conectando ao Year in Review.

Como revogo o acesso?

Remova o conector no seu cliente MCP — Claude → Configurações → Conectores → Desconectar, ou o equivalente no cliente que você usou. Isso também invalida a sessão OAuth no nosso servidor, então o acesso para na hora.

Outro problema

Escreva para [email protected] informando qual cliente está usando (Claude Desktop, Claude web, ChatGPT, Cursor, etc.), em que passo quebrou e — se possível — um print. Normalmente respondemos em até um dia.

Perguntas frequentes

A quais dados o conector tem acesso?

O esquema dos seus rastreadores, as entradas diárias e as configurações de usuário (fuso horário). Nada fora do app.

Posso revogar o acesso?

Sim. Remova o conector no seu cliente MCP e a sessão OAuth é invalidada no nosso servidor ao mesmo tempo.

O que fica guardado quando eu conecto?

Seu cliente MCP guarda um token de acesso de curta duração; nós guardamos apenas a sessão que o renova, nunca sua senha. Os tokens de acesso duram uma hora e se renovam sozinhos. Se você remover o conector, essa sessão é invalidada.

Existe limite de uso?

Sim — 60 chamadas por minuto e 500 por dia por usuário. O uso conversacional normal fica bem abaixo desses limites.

A IA vê minhas notas e entradas?

Apenas as entradas que a IA explicitamente lê ao responder seu pedido (por exemplo quando você pergunta sobre uma sequência). Nunca registramos o conteúdo das suas entradas nem o texto dos seus prompts. Registramos o nome da ferramenta, o status e a duração para depuração operacional.

Dúvidas? [email protected]