ContextStream MCP Server
npx --prefer-online -y @contextstream/mcp-server@latest setupPrimeros pasos (VS Code + Copilot)
Opción 1: Rust MCP (recomendado)
curl -fsSL https://contextstream.io/scripts/mcp.sh | bashirm https://contextstream.io/scripts/mcp.ps1 | iexLuego ejecuta:
contextstream-mcp setupOpción 2: Node MCP
npx --prefer-online -y @contextstream/mcp-server@latest setupDespués de la configuración, reinicia VS Code/Copilot.
Funciona con: Claude Code • Cursor • VS Code • Claude Desktop • Codex CLI • OpenCode • Antigravity
Esto no es solo memoria. Esto es inteligencia.
Otras herramientas le dan a tu IA un bloc de notas. ContextStream le da un cerebro.
Tu IA no solo recuerda cosas, sino que entiende toda tu base de código, aprende de cada conversación, extrae conocimiento de GitHub, Slack y Notion de tu equipo, y entrega exactamente el contexto correcto en el momento justo.
Una configuración. Transformación instantánea.
Qué cambia al instalar esto
Antes | Después |
La IA busca archivos uno por uno, consumiendo tokens | La búsqueda semántica encuentra código por significado en milisegundos |
El contexto se pierde cuando las conversaciones son largas | La compresión inteligente preserva lo importante antes de la compactación |
Conocimiento del equipo disperso en varias herramientas | Inteligencia unificada de GitHub, Slack y Notion, automáticamente |
Se repiten los mismos errores en las sesiones | El sistema de lecciones asegura que tu IA aprenda de cada fallo |
Respuestas genéricas, sin conocimiento del proyecto | Contexto profundo sobre tu arquitectura, decisiones y patrones |
El poder bajo el capó
Inteligencia de código semántica
Pregunta "¿dónde gestionamos la autenticación?" y obtén la respuesta al instante. Sin cadenas de grep. Sin leer 10 archivos. Tu IA entiende tu código a un nivel conceptual.
Entrega de contexto SmartRouter
Cada mensaje es analizado. ¿Una refactorización arriesgada? Las lecciones relevantes aparecen automáticamente. ¿Tomando una decisión? Tu IA sabe capturarla. El contexto correcto, siempre, sin que tengas que pedirlo.
Fusión de conocimiento del equipo
Conecta GitHub, Slack y Notion. ¿Discusiones de hace meses? Aparecen cuando son relevantes. ¿Esa decisión de arquitectura enterrada en un comentario de PR? Tu IA la conoce.
Análisis de grafo de código
"¿Qué depende de UserService?" "¿Cuál es el impacto de cambiar esta función?" Tu IA ve las conexiones en toda tu base de código.
Conciencia de presión de contexto
¿Conversación larga? ContextStream rastrea el uso de tokens, guarda automáticamente el estado crítico y asegura que no se pierda nada importante cuando el contexto se compacta.
Las herramientas que obtiene tu IA
init → Loads your workspace context instantly
context → Delivers relevant context every single message
search → Semantic, hybrid, keyword—find anything by meaning
session → Captures decisions, preferences, lessons automatically
memory → Builds a knowledge graph of your project
graph → Maps dependencies and analyzes impact
project → Indexes your codebase for semantic understanding
media → Index and search video, audio, images (great for Remotion)
integration → Queries GitHub, Slack, Notion directlyTu IA usa estas herramientas automáticamente. Tú solo programa.
Espacio de trabajo de respaldo global (carpetas no mapeadas)
ContextStream ahora admite un modo general para carpetas aleatorias (por ejemplo, ~ o directorios ad-hoc) que aún no están asociadas a un proyecto/espacio de trabajo.
init(...)resuelve primero los mapeos de carpetas normales (.contextstream/config.json, mapeos principales/globales).Si no existe ningún mapeo, utiliza un único espacio de trabajo de respaldo global oculto (
.contextstream-global) en modo solo espacio de trabajo.Las herramientas de contexto/memoria/sesión siguen funcionando sin errores de configuración.
Las acciones vinculadas al proyecto (por ejemplo,
project(action="ingest_local")) devuelven una guía de remediación para crear/seleccionar un proyecto en lugar de fallar con un error deproject_id required.Tan pronto como entras en una carpeta de proyecto mapeada, ese espacio de trabajo/proyecto real tiene prioridad y reemplaza el alcance de respaldo.
Configuración manual
Omite esto si ejecutaste el asistente de configuración.
claude mcp add contextstream -- npx --prefer-online -y @contextstream/mcp-server@latest
claude mcp update contextstream -e CONTEXTSTREAM_API_URL=https://api.contextstream.io -e CONTEXTSTREAM_API_KEY=your_key{
"mcpServers": {
"contextstream": {
"command": "npx",
"args": ["--prefer-online", "-y", "@contextstream/mcp-server@latest"],
"env": {
"CONTEXTSTREAM_API_URL": "https://api.contextstream.io",
"CONTEXTSTREAM_API_KEY": "your_key"
}
}
}
}Ubicaciones: ~/.cursor/mcp.json • ~/Library/Application Support/Claude/claude_desktop_config.json
Servidor local:
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"contextstream": {
"type": "local",
"command": ["npx", "-y", "contextstream-mcp"],
"environment": {
"CONTEXTSTREAM_API_KEY": "{env:CONTEXTSTREAM_API_KEY}"
},
"enabled": true
}
}
}Servidor remoto:
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"contextstream": {
"type": "remote",
"url": "https://mcp.contextstream.com",
"enabled": true
}
}
}Para la variante local, exporta CONTEXTSTREAM_API_KEY antes de iniciar OpenCode.
Ubicaciones: ./opencode.json • ~/.config/opencode/opencode.json
Para GitHub Copilot en VS Code, la ruta más fácil es el MCP remoto alojado con OAuth integrado. Las instalaciones desde el Marketplace deberían escribir esta definición de servidor remoto automáticamente.
MCP remoto alojado (recomendado)
{
"servers": {
"contextstream": {
"type": "http",
"url": "https://mcp.contextstream.io/mcp?default_context_mode=fast"
}
}
}En el primer uso, VS Code debería pedirte que autorices a ContextStream en el navegador y luego completar la configuración sin necesidad de una clave API en el archivo de configuración.
npx @contextstream/mcp-server@latest setup ahora establece por defecto VS Code/Copilot a este remoto alojado cuando utilizas el ContextStream cloud de producción. Para forzar un tiempo de ejecución local, ejecuta la configuración con CONTEXTSTREAM_VSCODE_MCP_MODE=local.
Para despliegues autoalojados o de API no predeterminados, el tiempo de ejecución local sigue siendo el predeterminado:
Rust MCP (recomendado)
{
"servers": {
"contextstream": {
"type": "stdio",
"command": "contextstream-mcp",
"args": [],
"env": {
"CONTEXTSTREAM_API_URL": "https://api.contextstream.io",
"CONTEXTSTREAM_API_KEY": "your_key",
"CONTEXTSTREAM_TOOLSET": "complete",
"CONTEXTSTREAM_TRANSCRIPTS_ENABLED": "true",
"CONTEXTSTREAM_HOOK_TRANSCRIPTS_ENABLED": "true",
"CONTEXTSTREAM_SEARCH_LIMIT": "15",
"CONTEXTSTREAM_SEARCH_MAX_CHARS": "2400"
}
}
}
}Servidor Node MCP
{
"servers": {
"contextstream": {
"type": "stdio",
"command": "npx",
"args": ["--prefer-online", "-y", "@contextstream/mcp-server@latest"],
"env": {
"CONTEXTSTREAM_API_URL": "https://api.contextstream.io",
"CONTEXTSTREAM_API_KEY": "your_key",
"CONTEXTSTREAM_TOOLSET": "complete",
"CONTEXTSTREAM_TRANSCRIPTS_ENABLED": "true",
"CONTEXTSTREAM_HOOK_TRANSCRIPTS_ENABLED": "true",
"CONTEXTSTREAM_SEARCH_LIMIT": "15",
"CONTEXTSTREAM_SEARCH_MAX_CHARS": "2400"
}
}
}
}Usa la CLI de Copilot para añadir interactivamente el servidor MCP:
/mcp addO añádelo a ~/.copilot/mcp-config.json (elige un tiempo de ejecución):
Rust MCP (recomendado)
{
"mcpServers": {
"contextstream": {
"command": "contextstream-mcp",
"args": [],
"env": {
"CONTEXTSTREAM_API_URL": "https://api.contextstream.io",
"CONTEXTSTREAM_API_KEY": "your_key",
"CONTEXTSTREAM_TOOLSET": "complete",
"CONTEXTSTREAM_TRANSCRIPTS_ENABLED": "true",
"CONTEXTSTREAM_HOOK_TRANSCRIPTS_ENABLED": "true",
"CONTEXTSTREAM_SEARCH_LIMIT": "15",
"CONTEXTSTREAM_SEARCH_MAX_CHARS": "2400"
}
}
}
}Servidor Node MCP
{
"mcpServers": {
"contextstream": {
"command": "npx",
"args": ["--prefer-online", "-y", "@contextstream/mcp-server@latest"],
"env": {
"CONTEXTSTREAM_API_URL": "https://api.contextstream.io",
"CONTEXTSTREAM_API_KEY": "your_key",
"CONTEXTSTREAM_TOOLSET": "complete",
"CONTEXTSTREAM_TRANSCRIPTS_ENABLED": "true",
"CONTEXTSTREAM_HOOK_TRANSCRIPTS_ENABLED": "true",
"CONTEXTSTREAM_SEARCH_LIMIT": "15",
"CONTEXTSTREAM_SEARCH_MAX_CHARS": "2400"
}
}
}
}Para más información, consulta la documentación de GitHub Copilot CLI.
Consejos para VS Code + Copilot
Ejecuta la configuración una vez y mantén ambos archivos de configuración:
~/.copilot/mcp-config.json.vscode/mcp.json
Instalación Rust: usa
contextstream-mcpcomo comando.Instalación Node: usa
npx --prefer-online -y @contextstream/mcp-server@latestcomo comando.Fuerza la configuración local de VS Code/Copilot con
CONTEXTSTREAM_VSCODE_MCP_MODE=local.Fuerza la configuración remota alojada de VS Code/Copilot con
CONTEXTSTREAM_VSCODE_MCP_MODE=remote.Usa
mcpServersen la configuración de la CLI de Copilot yserversen la configuración de VS Code.
Solución de problemas rápida
Elimina entradas duplicadas de ContextStream en los alcances de configuración de Workspace/User.
Comprueba que
CONTEXTSTREAM_API_URLyCONTEXTSTREAM_API_KEYestén configurados.Elimina versiones fijas obsoletas como
@contextstream/mcp-server@0.3.xx.Reinicia VS Code/Copilot después de realizar cambios en la configuración.
Limitaciones conocidas
OAuth de transporte HTTP y dependencia de vscode.dev
El transporte MCP HTTP alojado (https://mcp.contextstream.io/mcp) utiliza autenticación OAuth que se enruta a través de vscode.dev para el flujo de redirección. Esto puede fallar en entornos donde vscode.dev está bloqueado (redes corporativas, restricciones regionales, bloqueos a nivel de CDN).
Solución alternativa: Utiliza el transporte stdio (binario Rust o Node.js) con autenticación mediante clave API:
{
"contextstream": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@contextstream/mcp-server@latest"],
"env": {
"CONTEXTSTREAM_API_KEY": "your-api-key"
}
}
}Compatibilidad de versiones del SDK
Las versiones 1.28.0 y superiores de @modelcontextprotocol/sdk introducen cambios importantes. El package.json fija el SDK a >=1.25.1 <1.28.0 para evitar resoluciones incompatibles. Si experimentas errores de esquema Zod al iniciar, asegúrate de que tu versión del SDK sea inferior a 1.28.0.
Nota sobre el Marketplace
La entrada del marketplace de MCP ahora apunta al MCP remoto alojado en https://mcp.contextstream.io/mcp?default_context_mode=fast para que VS Code pueda usar el flujo OAuth nativo en lugar de escribir una configuración stdio local basada en npm.
Utiliza las configuraciones de tiempo de ejecución local de Rust o Node anteriores solo cuando desees explícitamente la ejecución local, puntos finales personalizados/autoalojados o entornos de editor que no admitan el flujo remoto alojado.
Enlaces
Sitio web: https://contextstream.io
Documentación: https://contextstream.io/docs
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/contextstream/mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server