The-Snip

Base de conhecimento da equipe para trechos de código, chamadas de API e documentação. Agentes pesquisam e arquivam itens via MCP; humanos revisam o que se torna canônico.

Ver em the-snip.comExperimente este MCPPatrocinado

Documentação

Experimente agora — sem cadastro

Cole esta configuração e seu agente pode pesquisar imediatamente um workspace de demonstração compartilhado somente leitura. Ele tem limite de taxa e suas gravações são sempre rejeitadas no servidor — cadastre-se para obter sua própria base e ganhe suas 5 gravações de agente gratuitas.

// workspace de demonstração compartilhado — esta chave funciona

{
  "mcpServers": {
    "the-snip-demo": {
      "url": "https://the-snip.com/mcp",
      "headers": {
        "Authorization": "Bearer snip_kTHay3_E_PRcubQBouPQM8hnHoEKhWvXAJS6MCZwSPwqDX-hkmsU"
      }
    }
  }
}

Como funciona

Seu agente pesquisa a base durante a tarefa (search_base) e obtém as respostas aprovadas da equipe.
Ele confia no que encontra — apenas itens aprovados por humanos são canônicos.
Quando aprende algo novo, ele registra de volta (create_snippet / create_api / create_doc / create_webpage) — toda gravação cai em revisão.
Um humano aprova na fila de revisão; a base permanece confiável.

Entregue um destes arquivos a qualquer agente de IA — o arquivo combinado cobre MCP + REST; o arquivo MCP é apenas o contrato desta página:

// the-snip-for-agents.md — cole no seu CLAUDE.md

Baixe o arquivo de instruções do agente

// the-snip-mcp-setup.md — configuração somente MCP, para o contexto do seu agente

Baixe o arquivo de configuração MCP

Como conectar

Crie um workspace em the-snip.com — grátis, sem cartão.
Gere uma chave de API em Configurações → Chaves de API.
Adicione o servidor ao seu cliente com uma das configurações abaixo.

// Claude Code — um comando

claude mcp add --transport http the-snip https://the-snip.com/mcp \
  --header "Authorization: Bearer snip_YOUR_WORKSPACE_KEY"

{
  "mcpServers": {
    "the-snip": {
      "url": "https://the-snip.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:THESNIP_API_KEY}"
      }
    }
  }
}

{
  "mcp": {
    "servers": {
      "the-snip": {
        "url": "https://the-snip.com/mcp",
        "transport": "streamable-http",
        "headers": {
          "Authorization": "Bearer snip_YOUR_WORKSPACE_KEY"
        }
      }
    }
  }
}

// Hermes (Nous Research) — ~/.hermes/config.yaml

mcp_servers:
  the-snip:
    url: "https://the-snip.com/mcp"
    headers:
      Authorization: "Bearer snip_YOUR_WORKSPACE_KEY"

// VS Code (modo agente do Copilot) —.vscode/mcp.json

{
  "inputs": [
    {
      "type": "promptString",
      "id": "thesnip-api-key",
      "description": "The-Snip workspace API key (snip_...)",
      "password": true
    }
  ],
  "servers": {
    "the-snip": {
      "type": "http",
      "url": "https://the-snip.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:thesnip-api-key}"
      }
    }
  }
}

// OpenAI Codex CLI — ~/.codex/config.toml

[mcp_servers.the-snip]
url = "https://the-snip.com/mcp"
bearer_token_env_var = "THESNIP_API_KEY"

{
  "mcpServers": {
    "the-snip": {
      "httpUrl": "https://the-snip.com/mcp",
      "headers": {
        "Authorization": "Bearer $THESNIP_API_KEY"
      }
    }
  }
}

{
  "mcpServers": {
    "the-snip": {
      "type": "streamableHttp",
      "url": "https://the-snip.com/mcp",
      "headers": {
        "Authorization": "Bearer snip_YOUR_WORKSPACE_KEY"
      }
    }
  }
}

{
  "mcpServers": {
    "the-snip": {
      "url": "https://the-snip.com/mcp",
      "headers": { "Authorization": "Bearer snip_YOUR_KEY" }
    }
  }
}

Funciona com

Qualquer cliente que fale Streamable HTTP e possa enviar um cabeçalho Authorization conecta-se hoje. Sintaxe de configuração por plataforma, verificada contra a documentação oficial de cada projeto (julho de 2026):

Plataforma	Arquivo de configuração	Autenticação por cabeçalho	Cuidado com
Claude Code	.mcp.json / claude mcp add	Sim	entradas .mcp.json precisam de "type": "http" — uma url sem tipo é um erro de configuração
Cursor	.cursor/mcp.json	Sim	a interpolação ${env:VAR} funciona em cabeçalhos — mantenha a chave fora do arquivo
OpenClaw	~/.openclaw/openclaw.json	Sim	defina "transport": "streamable-http"; a interpolação de env não é documentada — cole a chave
Hermes (Nous)	~/.hermes/config.yaml	Sim	allowed_tools pode expor apenas search_base para agentes somente leitura
VS Code Copilot	.vscode/mcp.json	Sim	a chave de nível superior é "servers", não "mcpServers"
OpenAI Codex CLI	~/.codex/config.toml	Sim	bearer_token_env_var envia o valor da env como cabeçalho Bearer
Gemini CLI	~/.gemini/settings.json	Sim	o campo é "httpUrl" — "url" significa SSE no Gemini CLI
Cline	painel Cline / ~/.cline/mcp.json	Sim	"type": "streamableHttp" deve ser explícito — omiti-lo volta ao SSE legado
Windsurf	~/.codeium/windsurf/mcp_config.json	Sim	o campo de URL é "serverUrl", não "url"
Continue	config.yaml	Sim	os cabeçalhos vão em requestOptions.headers, não em uma chave headers simples
Zed	settings.json	Sim	os servidores ficam em "context_servers"
Goose (Block)	~/.config/goose/config.yaml	Sim	o tipo é "streamable_http" com um campo "uri"

Os conectores personalizados do ChatGPT e do claude.ai agora também funcionam — via OAuth. Adicione um conector personalizado apontando para https://the-snip.com/mcp e seu navegador executa um login OAuth único: faça login no The-Snip, escolha um workspace e clique em Permitir — sem chave para colar. O conector então lê e propõe itens (em revisão) via MCP, limitados ao workspace que você escolheu. Revogue-o a qualquer momento em Configurações → Chaves de API → Aplicativos conectados.

Duas notas de configuração para conectores OAuth. O ChatGPT exige o Modo de desenvolvedor (Configurações → Conectores → Avançado) e mostra um aviso de “não verificado” durante a conexão — isso é esperado para qualquer conector personalizado. Workspaces gratuitos também conectam — leituras são gratuitas, com 5 gravações de agente gratuitas (com revisão) antes de precisar do Pro & Team. O caminho estático do cabeçalho Authorization: Bearer snip_… acima permanece inalterado e ainda é a opção mais simples para Claude Code, Codex e mcp-remote.

Clientes somente stdio podem fazer ponte com mcp-remote, configurado como servidor stdio:

// clientes somente stdio — ponte mcp-remote

npx -y mcp-remote https://the-snip.com/mcp --header "Authorization: Bearer snip_YOUR_WORKSPACE_KEY"

Nove ferramentas

Ferramenta	O que faz	Comportamento
search_base	Pesquise a base revisada da equipe de trechos de código, chamadas de API salvas e documentos Markdown. SEMPRE pesquise antes de criar — quase duplicatas degradam uma base compartilhada. Texto completo, não semântico: 2-4 palavras-chave funcionam melhor; se os resultados estiverem vazios, tente com sinônimos. Uma consulta vazia retorna os itens mais recentes. Retorna itens completos; pegue os ids daqui para get_item e update_item. Grátis em todos os planos.	somente leitura · grátis
get_item	Busque um item completo por id. Pegue os ids dos resultados de search_base — nunca adivinhe (um id fora do seu workspace retorna 404). Grátis em todos os planos.	somente leitura · grátis
list_collections	Liste as coleções do workspace (id e nome). Verifique antes de registrar: passe um collectionId real para create_* ou update_item para que os itens caiam onde a equipe espera — nunca adivinhe ids de coleção. Grátis em todos os planos.	somente leitura · grátis
create_snippet	Registre código reutilizável que vale a pena manter: um hook, um helper, uma correção que a equipe encontrará novamente. Pesquise primeiro para evitar duplicatas. Inclua description (o quê e quando) e sampleOutput (como é a saída correta — agentes futuros dependem disso). Cai em revisão: um humano aprova antes de se tornar canônico; "em revisão" é esperado, não reenvie. Plano gratuito: 5 gravações de agente vitalícias (com revisão); ilimitado no Pro & Team.	cai em revisão (201) · 5 grátis, depois pago
create_api	Registre uma solicitação de API que funciona — o método, URL, cabeçalhos e corpo que realmente funcionaram. Pesquise primeiro para evitar duplicatas. Use sampleResponse para mostrar como é uma boa resposta. Cai em revisão para aprovação humana; não reenvie enquanto estiver pendente. Plano gratuito: 5 gravações de agente vitalícias (com revisão); ilimitado no Pro & Team.	cai em revisão (201) · 5 grátis, depois pago
create_doc	Registre conhecimento em prosa: runbooks, tutoriais, notas de arquitetura, pegadinhas. O corpo é Markdown; [[wikilinks]] resolvem para outros documentos no workspace. Pesquise primeiro para evitar duplicatas. Cai em revisão para aprovação humana. Plano gratuito: 5 gravações de agente vitalícias (com revisão); ilimitado no Pro & Team.	cai em revisão (201) · 5 grátis, depois pago
create_webpage	Registre uma página web extraída que vale a pena manter: páginas de documentação, changelogs, postagens de blog que a equipe precisará novamente. sourceUrl é a URL canônica http(s) da página; body é o conteúdo da página convertido para Markdown. Pesquise primeiro para evitar duplicatas — re-extrair a mesma página? Use update_item no item existente em vez disso. Inclua description (o que a página cobre e por que foi salva). Cai em revisão: um humano aprova antes de se tornar canônico; não reenvie enquanto estiver pendente. Plano gratuito: 5 gravações de agente vitalícias (com revisão); ilimitado no Pro & Team.	cai em revisão (201) · 5 grátis, depois pago
update_item	Corrija ou estenda um item existente quando um resultado de pesquisa estiver desatualizado ou incompleto. Atualize por id de search_base — nunca adivinhe ids (404 se não estiver visível). Aceita qualquer campo de create, todos opcionais; a atualização recoloca o item em revisão. Também é assim que você move um item para uma coleção: passe collectionId de list_collections. Plano gratuito: 5 gravações de agente vitalícias (com revisão); ilimitado no Pro & Team.	recolocado em revisão · 5 grátis, depois pago
create_collection	Crie uma coleção para organizar itens. Verifique list_collections primeiro — não crie quase duplicatas de coleções existentes. Retorna a nova coleção incluindo seu id, pronta para usar como collectionId. Plano gratuito: 5 gravações de agente vitalícias (com revisão); ilimitado no Pro & Team.	201 — sem revisão (metadados organizacionais) · 5 grátis, depois pago

Agentes propõem, humanos aprovam

Toda gravação de agente — criar ou atualizar — cai com status "em revisão", e atualizar um item aprovado o recoloca em revisão. Os agentes estruturalmente não podem definir status: os esquemas de entrada rejeitam campos desconhecidos, então um campo contrabandeado status: "approved" retorna como 400, nunca uma aprovação silenciosa. Um humano aprova itens na fila de revisão, e apenas itens aprovados são canônicos. Essa barreira é o que torna a base confiável o suficiente para servir como uma memória de equipe revisada para Claude Code — veja como agentes leem e escrevem no The-Snip.

Solução de problemas

// 401 — chave ausente ou inválida

{"error":{"code":"unauthorized","message":"Missing API key"}}
{"error":{"code":"unauthorized","message":"Invalid API key"}}

Envie a chave como Authorization: Bearer snip_.... "Chave de API inválida" significa que a chave foi revogada ou digitada incorretamente — gere uma nova em Configurações → Chaves de API. Um 401 de /mcp também traz WWW-Authenticate: Bearer error="invalid_token".

// 403 — as 5 gravações de agente gratuitas do workspace foram usadas

{"error":{"code":"forbidden","message":"You've used your 5 free agent writes — they landed in your review queue. Unlimited agent writes are part of Pro & Team ($8/user): https://the-snip.com/upgrade"}}

Leituras (search_base, get_item, list_collections) são gratuitas em todos os planos, e todo workspace gratuito recebe 5 gravações de agente gratuitas (com revisão) — apenas gravações que têm sucesso contam, e as já registradas ficam seguras na fila de revisão. Gravações ilimitadas de agente fazem parte do Pro & Team: faça upgrade em the-snip.com/upgrade e a mesma chave continua gravando.

// 405 — sonda GET no endpoint

{"error":{"code":"method_not_allowed","message":"MCP is POST-only (Streamable HTTP). See https://the-snip.com/settings/api-keys for setup."}}

A resposta traz Allow: POST. O endpoint fala apenas Streamable HTTP — clientes no transporte SSE mais antigo abrem com GET e veem isso; mude a entrada do servidor para o tipo Streamable HTTP mostrado acima.

Perguntas, respondidas.

Como conecto o Claude Code ao servidor MCP do The-Snip?

Gere uma chave de API do workspace em Configurações → Chaves de API, depois adicione o The-Snip ao .mcp.json do seu projeto com a URL do servidor https://the-snip.com/mcp e o cabeçalho Authorization: Bearer snip_... (no .mcp.json a entrada também precisa de "type": "http"). O Claude Code a reconhece na próxima sessão e obtém todas as nove ferramentas. Cursor, Windsurf, VS Code Copilot e qualquer cliente MCP Streamable-HTTP conectam da mesma forma — veja a tabela de configuração por plataforma acima.

Quais ferramentas o servidor MCP expõe?

Nove. Leituras (grátis em todos os planos): search_base, get_item, list_collections. Gravações: create_snippet, create_api, create_doc, create_webpage, update_item, create_collection. Toda gravação cai em revisão — agentes não podem definir status, então um campo de status contrabandeado retorna 400.

O servidor MCP é gratuito?

Leituras são gratuitas em todos os planos — qualquer agente pode pesquisar a base no plano gratuito. Todo workspace gratuito também recebe 5 gravações de agente gratuitas (com revisão, vitalícias). Gravações ilimitadas de agente — criar e atualizar itens, e criar coleções — fazem parte do Pro & Team, $8/usuário/mês. Quando as 5 gravações gratuitas forem usadas, uma gravação de um workspace gratuito retorna 403 apontando para the-snip.com/upgrade, e os itens já registrados permanecem na fila de revisão.

Posso experimentar o servidor MCP sem me cadastrar?

Sim. Cole a configuração de demonstração acima e seu agente pode pesquisar imediatamente um workspace de demonstração compartilhado somente leitura. A chave de demonstração tem limite de taxa e suas gravações são sempre rejeitadas no servidor — cadastre-se para obter sua própria base e ganhar suas 5 gravações de agente gratuitas.

Os agentes precisam de assentos ou logins próprios?

Não. Agentes autenticam com chaves de API do workspace, não assentos — você paga por humano. Crie uma chave separada por agente ou por desenvolvedor para que qualquer uma possa ser revogada sem afetar as demais. Conectores personalizados do ChatGPT e do claude.ai também podem conectar via login OAuth único em vez de colar uma chave.