Docs · Integração

Use o vault do Wikify direto no Claude, Cursor ou ChatGPT.

O servidor MCP do Wikify expõe seu vault como ferramentas pra qualquer cliente que entende Model Context Protocol. Você conversa com a IA da sua escolha e ela busca, lê e atualiza suas apostilas como contexto — sem copiar texto.

Feature Plus e Pro

Setup completo em 2 minutos · Claude Desktop

O que dá pra fazer

Dez ferramentas disponíveis hoje. Quando você adiciona o MCP no Claude Desktop (ou Cursor), a IA passa a saber chamar elas durante a conversa.

wikify_search_vault

Busca semântica nas suas apostilas. Retorna trechos com a página exata do PDF.

Ex.: "Busca 'controle de constitucionalidade' no meu vault Wikify"

wikify_get_page

Markdown completo + frontmatter de uma página do vault (source, concept, entity).

Ex.: "Lê a página completa do conceito 'devido processo legal'"

wikify_list_due_flashcards

Lista flashcards SRS prontos pra revisão agora.

Ex.: "Quais meus flashcards de revisão de hoje no Wikify?"

wikify_review_flashcard

Aplica review com rating ("again" / "hard" / "good" / "easy"). Atualiza FSRS.

Ex.: "Vou revisar todos os cards de hoje — pergunta de cada um e marca como good ou again"

wikify_save_concept

Cria página de conceito no vault. Use pra capturar síntese feita pela IA.

Ex.: "Resume isso em uma página de conceito e salva no Wikify"

wikify_get_question

Questão oficial do banco público com gabarito e comentário IA.

Ex.: "Pega a questão cebraspe-2024-administrador-002"

wikify_get_study_plan

Plano de estudos semanal gerado pela IA pra um concurso salvo.

Ex.: "Mostra meu plano de estudos atual do Wikify"

wikify_create_study_plan

Cria um cronograma personalizado para concurso/vestibular brasileiro. Salva no perfil e ativa lembretes.

Ex.: "Me faz um plano pra TJSP - Escrevente, prova em nov/25, 3h por dia de seg a sex, fraco em Civil e Português"

wikify_get_schedule

Lê o cronograma de questões agendadas: dias, horários, status WhatsApp e Telegram.

Ex.: "Quais dias e horários estou recebendo questões no Wikify?"

wikify_set_schedule

Ajusta os dias e horários em que o user recebe questões via WhatsApp/Telegram. Requer Plus/Pro para ativar opt-in.

Ex.: "Muda meu cronograma pra segunda, quarta e sexta às 19h"

Setup

1Gerar token

Vai em wikify.studio/app/settings/mcp e clica em "Gerar token". O token aparece em texto claro uma vez — copia ele.

Formato: wkfy_seguido de 24 caracteres aleatórios.

2Claude Desktop

Abre claude_desktop_config.json(Settings → Developer → Edit Config) e adiciona:

{
  "mcpServers": {
    "wikify": {
      "transport": "streamable-http",
      "url": "https://wikify.studio/api/mcp",
      "headers": {
        "Authorization": "Bearer SEU_TOKEN"
      }
    }
  }
}

Reinicia o Claude Desktop. Em uma nova conversa, a IA passa a ter as 8 ferramentas disponíveis.

3Cursor / Continue

Mesma config. Cursor lê ~/.cursor/mcp.json; Continue lê ~/.continue/config.json dentro da chave experimental.modelContextProtocolServers.

4Hermes Agent (CLI) — em validação

Hermes é um CLI agent local com suporte nativo a MCP. O servidor do Wikify foi testado e conecta normalmente; estamos finalizando a integração formal pra publicação no registry. Setup atual (≥0.13.0):

Opção A — comando direto:

hermes mcp add wikify \
  --url https://wikify.studio/api/mcp \
  --auth-bearer "$WIKIFY_TOKEN"

Opção B — editar ~/.hermes/config.yaml diretamente:

mcp_servers:
  wikify:
    url: https://wikify.studio/api/mcp
    auth:
      type: bearer
      token: SEU_TOKEN

Sintaxe do yaml pode variar conforme a versão do Hermes — se a Opção A já funcionou, prefira ela. Use hermes mcp --help pra confirmar.

Validar conexão:

hermes mcp test wikify
hermes mcp list

Reload sem fechar: /reload-mcp dentro de uma sessão ativa, ou abra uma nova sessão.

5ChatGPT — em validação

ChatGPT suporta MCP via Custom Connectors (Pro / Business / Enterprise), mas pra figurar oficialmente no diretório como integração nativa precisa ser app publicado via Apps SDK e aprovado pela OpenAI. Estamos no processo. Por enquanto, foque no Claude Desktop.

6IA local (Ollama, LM Studio) — via Continue ou Cursor

Roda modelo local no seu Mac/PC e ainda consome o vault Wikify? Dá. Qualquer client MCP-compatível serve de ponte: configure Continue ou Cursor apontando o chat pra um modelo local (Llama 3, Qwen, DeepSeek, etc. via Ollama ou LM Studio) e adicione o servidor MCP do Wikify nas configurações de tools. O modelo local enxerga as 10 ferramentas e age sobre o seu vault sem mandar dado pra nuvem de IA — só pro endpoint do Wikify autenticado.

Útil pra quem quer privacidade total no modelo (LGPD, dados sensíveis de cliente), latência baixa, ou só não pagar token de cloud. Wikify cuida do RAG (vault, questões, flashcards) e o modelo local cuida da geração.

⚠ MCP é exclusivo Plus/Pro. Plano Free tem acesso completo ao site (leitor, vault, flashcards, questões salvas), mas não conecta clients externos via MCP. Ver planos.

Limites e segurança

Rate limit: 200 chamadas/dia no Plus, 1.000/dia no Pro. Reset 24h após o primeiro uso. tools/list e initialize são grátis (metadata).
Auth: Bearer token no header. 1 token por user — rotacionar substitui o anterior. Revogar invalida em todos os clients conectados.
Escopo: Cada token só lê/escreve no vault do dono. Ownership verificada em todo call. Nenhum dado cruza entre users.
Tokens vazados: começa com wkfy_ — fácil detectar em CI scanners. Se vazou, revoga e gera novo.