AI Context Flow

Servidor MCP de Plurality

Memoria universal para agentes y herramientas de IA. Guarda, organiza y busca contexto en cualquier lugar.

Un servidor de Model Context Protocol que brinda a cualquier cliente de IA compatible con MCP memoria persistente: documentos, notas, conversaciones y archivos almacenados en buckets de memoria organizados con búsqueda semántica. Admite autenticación mediante OAuth y Tokens de Acceso Personal (PAT).

¿Por qué usar esto?

• Memory Studio — una base de conocimiento personal y segundo cerebro donde organizas contexto en buckets de memoria, revisas contenido guardado y gestionas lo que tus agentes de IA saben.
• Guarda chats importantes — directamente desde Claude, ChatGPT, Cursor y otras herramientas de IA en el bucket de memoria relevante.
• Memoria persistente compartida entre todos tus agentes: Claude Code, Lovable, Cursor, OpenClaw y más acceden al mismo contexto.
• Búsqueda semántica — encuentra recuerdos relevantes usando lenguaje natural, no solo palabras clave.
• Comparte buckets con otras personas — colabora dando a otros acceso a tu contexto.
• Funciona en todas partes — cualquier cliente compatible con MCP puede conectarse.

También tenemos una extensión de Chrome llamada AI Context Flow que te permite capturar y usar contexto en cualquier sitio web. Incluye un agente de chat integrado (más de 30 modelos) que se abre como barra lateral en cualquier página: habla con tus recuerdos, responde preguntas desde tu contexto almacenado y descubre conexiones entre todo lo que has guardado. Puedes usar el Servidor MCP junto con la extensión para obtener el conjunto completo de funciones del producto.

▶️ Ver la demo

📖 Documentación completa · 🌐 Sitio web · 🧩 Extensión de Chrome · 🧠 Memory Studio

Conexión rápida (producción)

URL de producción: https://app.plurality.network/mcp

El servidor admite OAuth 2.1 con PKCE (para clientes interactivos) y Tokens de Acceso Personal (para agentes sin interfaz y CI). La mayoría de los clientes manejan el flujo OAuth automáticamente.

Funciona con Claude Desktop, Claude Code, ChatGPT, Cursor y cualquier cliente compatible con MCP.

→ Guías de configuración paso a paso para todos los clientes compatibles

Herramientas

Autenticación

El servidor MCP acepta dos métodos de autenticación:

Uso de un Token de Acceso Personal

1. Inicia sesión en el panel de control, abre Conectar vía MCP → Gestionar tokens
2. Haz clic en Crear token, asígnale un nombre y una caducidad opcional, copia el valor de plur_pat_…
3. Configura tu cliente para enviarlo como token Bearer:

Authorization: Bearer plur_pat_...

Los PAT requieren un plan de pago. Se revocan automáticamente al caducar, pueden rotarse con un período de gracia configurable (7 días por defecto) y pueden revocarse inmediatamente desde el panel de control. Se almacenan con hash y nunca aparecen en los registros.

Detalles de OAuth

El servidor usa Ory Hydra como proveedor OAuth2/OIDC:

Arquitectura

MCP Client (Claude Code, Cursor, etc.)
    │
    │  OAuth2 + Streamable HTTP
    ▼
Traefik (:5050)           ← single entrypoint for clients
    ├── /mcp              → MCP Server (:5051)
    ├── /.well-known/*    → API Gateway or Hydra
    ├── /oauth2/*         → Hydra (:4444)
    └── /register         → API Gateway (DCR proxy)
                                │
                                │ Bearer token
                                ▼
                          API Gateway (:5000)
                                │
                                ▼
                          Vector Service (:8000)

Traefik es el único punto de entrada. Enruta el tráfico OAuth a Hydra y el tráfico del protocolo MCP al servidor MCP. El servidor MCP valida los JWT localmente mediante las claves JWKS de Hydra, luego reenvía el token Bearer a la Puerta de Enlace API para el acceso a datos. La Puerta de Enlace API maneja la autenticación, el proxy DCR y enruta las operaciones de vectores/búsqueda al Servicio de Vectores.

Configuración de desarrollo local

Requisitos previos

• Python 3.11+
• uv (gestor de paquetes de Python)
• Docker y Docker Compose
• Puerta de Enlace API en ejecución (plurality-backend-api): maneja autenticación, metadatos OAuth, proxy DCR y acceso a la base de datos
• Servicio de Vectores en ejecución (plurality-ai-service): maneja búsqueda semántica y operaciones de base de datos vectorial

1. Instalar dependencias

cd plurality-mcp-server
pip install uv
uv sync

2. Configurar el entorno

cp .env.example .env

Los valores predeterminados funcionan para el desarrollo local: no se necesitan cambios si la Puerta de Enlace API se ejecuta en :5000:

HYDRA_ISSUER=http://localhost:5050
MCP_RESOURCE_URL=http://localhost:5050
BACKEND_API_URL=http://localhost:5000

3. Iniciar los servicios Docker (Hydra + Traefik)

cd ory-hydra
docker compose up -d

Esto inicia:

Espera a que los servicios estén saludables: docker compose ps

4. Iniciar el servidor MCP

uv run uvicorn main:mcp_server --host 0.0.0.0 --port 5051 --reload

Puerto 5051, no 5050. Traefik escucha en 5050 y envía por proxy /mcp al servidor MCP en 5051.

5. Verificar

# Health check (direct)
curl http://localhost:5051/mcp/health

# OAuth metadata (via Traefik)
curl http://localhost:5050/.well-known/oauth-protected-resource

# Traefik dashboard (for debugging routes)
open http://localhost:8080

Configuración de cliente local

claude mcp add --transport http plurality-memory http://localhost:5050/mcp

{
  "mcpServers": {
    "plurality-memory": {
      "type": "http",
      "url": "http://localhost:5050/mcp"
    }
  }
}

{
  "mcpServers": {
    "plurality-memory": {
      "command": "npx",
      "args": ["mcp-remote", "http://localhost:5050/mcp"]
    }
  }
}

npx @modelcontextprotocol/inspector

Nota: ChatGPT no es compatible con el desarrollo local: requiere endpoints OAuth accesibles públicamente.

Estructura del proyecto

plurality-mcp-server/
├── main.py                             # Entry point
├── pyproject.toml                      # Dependencies (managed by uv)
├── .env.example                        # Environment template
├── src/plurality_mcp_server/
│   ├── app.py                          # FastMCP app + middleware stack
│   ├── config.py                       # Env vars, shared HTTP client, context vars
│   ├── auth.py                         # JWT validation via Hydra JWKS + scope check
│   └── tools.py                        # MCP tool definitions (read + write)
└── ory-hydra/
    ├── docker-compose.yml              # Hydra + Traefik + PostgreSQL
    ├── hydra.yml                       # Hydra OAuth2/OIDC config
    ├── traefik.yml                     # Traefik static config
    └── dynamic.yml                     # Traefik routing rules

Solución de problemas

Enlaces

• 📖 Documentación
• 🌐 Sitio web
• 🧩 Extensión de Chrome
• 🧠 Memory Studio
• 📦 Registro MCP
• 🔧 Smithery