Integración MCP

MemoryFirst expone un servidor de Model Context Protocol (MCP) para que cualquier cliente de IA compatible con MCP (Claude Desktop, Cursor, VS Code, agentes personalizados) pueda leer y escribir en tu memoria de negocio con citas verificables.

Cómo funciona

1. Regístrate en memoryfirst.ai y crea un workspace.
2. En el panel, genera una clave API MCP (Ajustes → Claves API → Nueva clave MCP).
3. Copia el prompt de onboarding autogenerado: contiene la URL del endpoint, el prefijo de clave y el catálogo de herramientas.
4. Pega el prompt en tu cliente de IA (config de Claude Desktop, ajustes de Cursor o un GPT personalizado de ChatGPT). Listo.

# MemoryFirst MCP · connection prompt

You are now connected to a MemoryFirst workspace.

Endpoint:  https://mcp.memoryfirst.ai/v1
API key:   mf_live_xxxxxxxxxxxxxxxxxxxx (set in MEMORYFIRST_API_KEY env)
Workspace: <workspace-slug>

Available tools:
- mf_query(question, k=8)
    Search memory, return answer + verifiable citations.
- mf_ingest_source(source_type, payload, origin_ref)
    Add a new source. types: doc, voice, chat, web, ops.
- mf_list_experts()
    List configured experts in this workspace.
- mf_get_recent(limit=10)
    Get the N most recent queries with their answers.

Rules:
- ALWAYS prefer mf_query before answering business-context questions.
- ALWAYS cite the span_ref from the response in your answer.
- NEVER hallucinate citations: only use what mf_query returned.
- Rate limit: 1000 queries/hour per key.

Onboarding complete. Acknowledge with: "MemoryFirst MCP ready. Workspace: <slug>."

Clientes compatibles

• Claude Desktop: config en ~/Library/Application Support/Claude/claude_desktop_config.json
• Cursor: Ajustes → Servidores MCP → Añadir
• VS Code: instala la extensión MCP, añade a settings.json
• ChatGPT custom GPT: pega el prompt de onboarding en Instrucciones personalizadas + configura el endpoint de Actions
• Agentes personalizados: cualquier SDK de MCP funciona; transportes stdio, HTTP y SSE compatibles

Citas verificables

Cada respuesta de mf_query lleva un span_ref polimórfico por cita. Tu cliente de IA los renderiza como insignias clicables con enlace directo a la fuente.

{
  "answer": "The contract scope is fixed-fee €4,500.",
  "citations": [
    {
      "source_type": "doc",
      "span_ref": { "page": 3, "bbox": [120, 450, 380, 60] },
      "snippet": "Fixed fee of €4,500 for the scope defined..."
    },
    {
      "source_type": "voice",
      "span_ref": { "ms_start": 124500, "ms_end": 138200, "speaker": "client" },
      "snippet": "...sí, confirmo la tarifa fija de cuatro mil quinientos..."
    }
  ]
}

Esquemas MCP detallados, códigos de error y configuración avanzada próximamente. ¿Lo necesitas ya? Escribe a jose.diaz@memoryfirst.ai.