MarkIt

MarkIt MCP - conecte sua IA à sua biblioteca

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

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

MarkIt salva os links, posts e anotações 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 afins - à sua biblioteca MarkIt através do Model Context Protocol aberto.

Uma vez conectado, 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 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

Todos os outros

Aplicativo	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 (Free 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 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 usar 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 há cabeçalho de Autorização.

Opção 2 - use sua chave de API

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

Aplicativo	Configuração
Claude Code	clients/claude-code.md
Cursor	clients/cursor.json
VS Code	clients/vscode.json
Codex CLI + aplicativo de desktop do ChatGPT	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 senha, nunca 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	Salve uma URL ou uma anotação 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	Defina ou reagende um lembrete em um item (e-mail para todos; WhatsApp/Telegram no Pro).
list_reminders	Seus lembretes pendentes.
cancel_reminder	Cancele um lembrete por id. Nunca toca no item em si; lembretes sincronizados com o Google Agenda permanecem gerenciados no site.
send_feedback	Envie uma nota curta diretamente ao fundador do MarkIt - apenas 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 qualquer outra pessoa. O conteúdo salvo das páginas é tratado como dados, nunca como instruções.

Privacidade, em uma frase

Sua IA fala com o MarkIt com 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 pelo 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 de 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é ser corrigido.
• A janela de login nunca volta: termine o login na aba do navegador que abriu e tente novamente pelo aplicativo; alguns aplicativos precisam de uma nova tentativa após a primeira autorização.
• Shim mcp-remote: mantenha-o atualizado (mcp-remote@latest; versões anteriores à 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 travado? support@mark-it.co.

Para sua IA

Aponte seu assistente para llms.txt - um manual 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 além: copie a pasta skill/ para .claude/skills/markit/ e o Claude capta automaticamente o manual completo de uso do MarkIt (quando pesquisar vs. salvar, etiqueta de anotações, tratamento de lembretes).

Licença

MIT. O nome e o logotipo MarkIt pertencem à MarkIt.