Context — ctxt.io

Contexto para agentes de IA (via MCP)

O ctxt.io é um servidor hospedado de Model Context Protocol.

Conecte-o ao Claude Code, Codex, Cursor, VS Code ou qualquer cliente MCP, e seu agente de IA pode transformar diffs, logs, trechos e documentos em links de compartilhamento com expiração automática — e lê-los de volta. Sem conta, sem chave de API, nada para instalar.

O empacotamento do lado do cliente é open source: o plugin do Claude Code, o plugin do Codex, a skill /share e as receitas de instalação abaixo estão todos em ctxt-io/ctxt-agents no GitHub. Se for útil para você, uma estrela ajuda outras pessoas a encontrarem.

Configuração no seu cliente

O servidor está em https://ctxt.io/mcp (remoto, Streamable HTTP).

Claude Code

claude mcp add --scope user --transport http ctxt https://ctxt.io/mcp

--scope user o disponibiliza em todos os projetos. Remova-o para adicionar o ctxt apenas ao projeto atual.

Ou inclua uma configuração com escopo de projeto no seu repositório para que todo o time o receba — adicione isto a .mcp.json:

{
  "mcpServers": {
    "ctxt": { "type": "http", "url": "https://ctxt.io/mcp" }
  }
}

Ou instale o plugin, que adiciona um comando /share e uma skill que ensina o Claude quando compartilhar e como produzir saída HTML de boa aparência. Execute estes comandos um de cada vez no Claude Code:

1. Adicione o marketplace:

/plugin marketplace add ctxt-io/ctxt-agents

2. Instale o plugin:

/plugin install ctxt@ctxt

Codex

codex mcp add ctxt --url https://ctxt.io/mcp

Ou adicione a ~/.codex/config.toml:

[mcp_servers.ctxt]
url = "https://ctxt.io/mcp"

Claude Desktop / claude.ai

Configurações → Conectores → Adicionar conector personalizado → insira https://ctxt.io/mcp.

Cursor

Ou adicione manualmente a .cursor/mcp.json (projeto) ou ~/.cursor/mcp.json (global):

{
  "mcpServers": {
    "ctxt": { "url": "https://ctxt.io/mcp" }
  }
}

VS Code

Adicione a .vscode/mcp.json:

{
  "servers": {
    "ctxt": { "type": "http", "url": "https://ctxt.io/mcp" }
  }
}

Qualquer outro

Aponte qualquer cliente MCP para https://ctxt.io/mcp. O servidor é stateless Streamable HTTP: respostas JSON simples, sem stream SSE, sem IDs de sessão, sem autenticação.

Grátis vs Pro

Recurso	Grátis	Pro ($1 por link)
Expiração	5m, 30m, 1h, 8h ou 1d	30 dias
Nome personalizado na URL	—	✓
Proteção por senha	—	✓

Links gratuitos são criados instantaneamente. Quando seu agente solicitar ttl=30d, o link é criado em estado pendente e o resultado da ferramenta inclui um payment_url — abra-o em um navegador e conclua o checkout de $1 para ativar os 30 dias (e as opções de nome/senha). Até o pagamento, o link dura 1 dia.

Pagamentos agênticos: plataformas de agentes cadastradas conosco podem pular a etapa do navegador completamente — quando habilitado, o resultado da ferramenta carrega um bloco acp (Agentic Commerce Protocol) e a plataforma conclui a compra de $1 programaticamente com um Stripe Shared Payment Token. Se você desenvolve uma plataforma de agentes e quer acesso, entre em contato.

As ferramentas

create_context

Compartilhe conteúdo como um link com expiração.

• content (obrigatório) — o texto a compartilhar, até 4MB.
• ttl — 5m, 30m, 1h (padrão), 8h, 1d ou 30d.
• format — text (padrão, verbatim), markdown (renderizado), code (com realce de sintaxe; lang opcional) ou html (sanitizado e renderizado — a melhor escolha para saída visual).
• name, password — opções Pro, honradas com ttl=30d.

Retorna a URL de compartilhamento, suas variantes .md /.txt /.json, o tempo de expiração e um delete_token que autoriza exclusão posterior — trate o token como um segredo.

Saída visual: quando seu agente produzir um relatório estilizado, uma tabela comparativa ou um gráfico, peça para ele enviar HTML autocontido com format=html — CSS inline e SVG inline renderizam completamente, e isso supera markdown para qualquer coisa visual. Tags <script> são removidas no servidor e JavaScript nunca executa, então mantenha-o estático. Por exemplo:

{
  "content": "<div style='font-family:system-ui'><h2>Deploy readiness</h2><table style='border-collapse:collapse'><tr><th style='padding:6px'>Check</th><th style='padding:6px'>Status</th></tr><tr><td style='padding:6px'>Tests</td><td style='padding:6px;color:#080'>445 passed</td></tr><tr><td style='padding:6px'>Coverage</td><td style='padding:6px'><svg width='120' height='10'><rect width='120' height='10' fill='#eee'/><rect width='101' height='10' fill='#2a7'/></svg> 84%</td></tr></table></div>",
  "format": "html",
  "ttl": "8h"
}

read_context

Busque um link ctxt.io existente como markdown (padrão), texto simples ou HTML. Aceita a URL completa, o caminho /3/<code> ou o código puro, além de password para links protegidos.

delete_context

Exclua um link que você criou, usando seu delete_token. Remove imediatamente o acesso público e solicita a exclusão do armazenamento de suporte. Destrutivo — agentes devem confirmar com você antes de chamá-lo.

Lendo colagens sem MCP

Toda URL de colagem tem versões gêmeas legíveis por robôs: acrescente .md, .txt ou .json. A versão gêmea .json retorna o conteúdo mais ttl, created e expires_at:

curl https://ctxt.io/3/YOURKEY.json

MCP é a forma suportada para máquinas criarem colagens — ele carrega os limites de taxa e as proteções contra abuso que mantêm o serviço gratuito. Criar colagens por outros meios automatizados é uma violação dos nossos Termos de Serviço (seção 3) e pode resultar em limitação de taxa ou bloqueio.

Limites e segurança

• Links são acessíveis por portador: qualquer pessoa com a URL pode lê-los até expirarem.
• O conteúdo é armazenado em forma simples em repouso. A proteção por senha é um portão de acesso, não criptografia.
• Senhas e tokens de exclusão passam pelo transcript do seu agente — não reutilize uma senha que importa.
• O conteúdo é limitado a 4MB por link; a criação é limitada por taxa por IP; links compartilhados são excluídos dos mecanismos de busca.
• O conteúdo pode ser processado automaticamente, inclusive por provedores de serviço, para detectar abuso. Não é usado para treinar ou ajustar modelos generativos de IA, e provedores não têm permissão para fazê-lo.

Descobrindo este servidor

O servidor está publicado no registro oficial de MCP como io.ctxt/mcp, e os plugins e skills são desenvolvidos abertamente em github.com/ctxt-io/ctxt-agents — issues e pull requests são bem-vindos. Perguntas ou ideias: feedback@ctxt.io.