MarkIt

Conecte o Claude ou o ChatGPT à sua biblioteca MarkIt para pesquisar, salvar e definir lembretes em tudo o que você salvou.

GitHub

Experimente este MCPPatrocinado

Documentação

MarkIt MCP - conecte sua IA à sua biblioteca

Traga sua própria IA. MarkIt é a memória.

[!TIP] O caminho preguiçoso (recomendado): cole a URL deste repositório na sua IA e diga "conecte-me ao MarkIt". Ela lê llms.txt e cuida de tudo abaixo para você.

MarkIt salva os links, posts e notas que você perderia de outra forma e os torna pesquisáveis em linguagem natural. Este repositório é o guia oficial para conectar sua própria IA - Claude, ChatGPT, Cursor e outros - à sua biblioteca MarkIt por meio do Model Context Protocol aberto.

Uma vez conectada, sua IA pode pesquisar sua biblioteca, ler o que encontrar, salvar novas coisas nela e definir lembretes. Nas suas palavras, não em palavras-chave.

Server URL:  https://mark-it.co/api/mcp
Transport:   Streamable HTTP
Auth:        OAuth 2.1 (sign in) or a personal API key (mkt_...)

Escolha seu caminho

Opção 1 - Entrar (OAuth). Sem chave para gerenciar. Cole a URL do servidor onde seu aplicativo pede um conector personalizado ou servidor MCP e entre no MarkIt quando o navegador abrir. Melhor para Claude, ChatGPT web, Cursor, VS Code.

Opção 2 - Chave de API. Gere uma chave em Configurações > Integrações (mostrada uma vez, mantenha-a em segredo). Melhor para CLIs, scripts e o aplicativo de desktop do ChatGPT.

Opção 1 - entre pelo seu aplicativo

Instalações com um clique

Para todos os outros

App	Passos
Claude (claude.ai + Claude Desktop)	Configurações > Conectores (em Personalizar) > Adicionar conector personalizado > cole `https://mark-it.co/api/mcp` > autorize. Disponível em todos os planos (o gratuito permite um conector personalizado). Problema conhecido: um bug aberto do lado da Anthropic pode falhar a autorização logo após você aprovar - se isso acontecer, use Claude Code (abaixo) até a Anthropic lançar a correção.
ChatGPT (web)	Configurações > Segurança e login > ative o Modo de desenvolvedor, depois Configurações > Plugins (ou chatgpt.com/plugins) > + > cole a URL do servidor > conecte com OAuth.
Claude Code	`claude mcp add --transport http markit https://mark-it.co/api/mcp` e depois execute `/mcp` em uma sessão e escolha Autenticar. Adicione `--scope user` para usá-lo em todos os projetos.
Codex CLI	Adicione o servidor (veja clients/codex.toml, pule a linha do token) e depois `codex mcp login markit`.
Zed	Adicione uma entrada `context_servers` apenas com o `url` (veja clients/zed.json); o Zed guia você pelo OAuth quando não houver cabeçalho Authorization.

Opção 2 - use sua chave de API

Em Configurações do MarkIt > Integrações, abra Conecte sua IA e gere sua chave. Ela começa com mkt_ e é mostrada uma vez.
Pegue a configuração do seu aplicativo em clients/ e substitua mkt_your_key_here:

App	Config
Claude Code	clients/claude-code.md
Cursor	clients/cursor.json
VS Code	clients/vscode.json
Codex CLI + ChatGPT desktop app	clients/codex.toml (eles compartilham `~/.codex/config.toml`)
Windsurf	clients/windsurf.json
Cline	clients/cline.json
Zed	clients/zed.json
Qualquer coisa somente stdio	clients/mcp-remote.json

Regras da chave: uma por conta, trate-a como uma senha, nunca a cole em um chat, revogue ou regenere a qualquer momento nas Configurações.

O que sua IA recebe

Ferramenta	O que ela faz
`search`	Pesquisa em linguagem natural na sua biblioteca, com filtros opcionais (categoria, plataforma, tipo, autor, tags, datas).
`fetch`	Conteúdo completo armazenado de um item por id.
`list_categories`	Suas categorias com contagens de itens.
`save_item`	Salva uma URL ou uma nota de texto na sua biblioteca. O MarkIt faz scraping, categoriza e indexa. Cada salvamento gasta uma captura mensal; salvar novamente uma URL que você já tem é uma operação gratuita sem efeito.
`create_reminder`	Define ou reagenda um lembrete em um item (e-mail para todos; WhatsApp/Telegram no Pro).
`list_reminders`	Seus lembretes pendentes.
`cancel_reminder`	Cancela um lembrete por id. Nunca toca no item em si; lembretes sincronizados com o Google Calendar permanecem gerenciados no site.
`send_feedback`	Envia uma nota curta diretamente ao fundador do MarkIt - somente quando você pedir. Uma pessoa real lê cada uma. Máximo de 3 por dia.

O que ela NÃO pode fazer, por design: excluir itens, editar sua conta, tocar nos dados de outras pessoas. O conteúdo salvo de páginas é tratado como dados, nunca como instruções.

Privacidade, em uma frase

Sua IA fala com o MarkIt com a sua identidade e só vê seus itens. Qualquer IA que você conectar (Claude, ChatGPT, ...) é sua própria ferramenta sob seus próprios termos - o MarkIt não envia sua biblioteca para lugar nenhum por conta própria. As concessões OAuth são revogáveis no seu aplicativo de IA; a chave de API é revogável nas Configurações. Detalhes completos: Política de Privacidade.

Solução de problemas

401 logo após conectar com uma chave: o cabeçalho deve ser exatamente Authorization: Bearer mkt_... - verifique se não há espaço perdido ou chave truncada (regenerar nas Configurações invalida chaves antigas).
Windsurf: o campo do servidor remoto é serverUrl, não url.
Cline: defina "type": "streamableHttp" explicitamente.
VS Code diz que não consegue iniciar o servidor: uma entrada com url também precisa de "type": "http".
Claude diz "Falha na autorização com o MarkIt" logo após você aprovar: bug conhecido do lado da Anthropic nos conectores personalizados do claude.ai (nosso servidor completa todo o fluxo OAuth; o Claude o descarta após o token). Use Claude Code ou Cursor até que seja corrigido.
A janela de login não volta: conclua o login na aba do navegador que ela abriu e tente novamente no aplicativo; alguns aplicativos precisam de uma nova tentativa após a primeira autorização.
mcp-remote shim: mantenha-o atualizado (mcp-remote@latest; versões anteriores a 0.1.16 têm uma vulnerabilidade crítica conhecida). Sem espaço ao redor dos dois pontos em Authorization:${AUTH_HEADER} no Windows.
Ainda preso? support@mark-it.co.

Para sua IA

Aponte seu assistente para llms.txt - um guia em texto simples que ensina a conectar você e a usar bem as ferramentas. Mesmo arquivo, URL com marca: mark-it.co/mcp/llms.txt.

Usuários do Claude Code podem ir um passo além: copie a pasta skill/ para .claude/skills/markit/ e o Claude adotará automaticamente o guia completo de uso do MarkIt (quando pesquisar vs salvar, etiqueta de notas, gerenciamento de lembretes).

Licença

MIT. O nome e o logotipo do MarkIt pertencem ao MarkIt.