KnowSync AI

No se encontraron encabezados

Conecta agentes de IA a tu base de conocimiento de KnowSync mediante el Protocolo de Contexto de Modelo (MCP). Configura claves de API, ajusta herramientas e intégrate con Claude, Cursor y otros asistentes de IA.

15 min de lecturaPor el equipo de KnowSync9/18/2025

Integración MCP

El servidor MCP (Protocolo de Contexto de Modelo) de KnowSync permite que los agentes de IA accedan a la base de conocimiento de tu organización en tiempo real. Conecta Claude, Cursor, VS Code y otras herramientas de IA para buscar, recuperar y añadir contenido a tu base de conocimiento sin interrupciones.

¿Qué es MCP?

Descripción general

El Protocolo de Contexto de Modelo (MCP) es un estándar abierto desarrollado por Anthropic que permite a las aplicaciones de IA acceder de forma segura a fuentes de datos externas. El servidor MCP de KnowSync proporciona 2 herramientas unificadas con caché inteligente, optimización de consultas impulsada por IA y gestión de sesiones que permiten a los agentes de IA interactuar con tu base de conocimiento a través de una API JSON-RPC 2.0 estandarizada.

Características clave

2 herramientas unificadas:

• Consulta universal: búsqueda y recuperación inteligente con detección automática de intención, reordenamiento impulsado por IA, caché inteligente y preservación de contexto consciente de la sesión
• Gestión de documentos: gestión integral de contenido que incluye rastreo web, descubrimiento y operaciones de documentos con seguimiento de uso

Seguridad empresarial:

• Autenticación mediante clave de API con permisos granulares
• Límite de velocidad y seguimiento de uso
• Atribución de miembros del equipo para todas las solicitudes
• Restricciones de IP y controles de acceso

Configuración de claves de API MCP

Creación de tu primera clave de API

1. Accede al panel MCP: navega al panel de tu organización y haz clic en la tarjeta Servidor MCP
2. Ve a la pestaña de claves de API: haz clic en la sección Claves de API
3. Crea una nueva clave: haz clic en el botón Crear clave de API
4. Configura los ajustes de la clave:
   • Nombre: nombre descriptivo (p. ej., "Claude Desktop", "Pruebas de desarrollo")
     • Permisos: selecciona qué herramientas puede acceder la clave
     • Límite de velocidad: establece solicitudes por hora (según tu plan)

Herramientas MCP disponibles

KnowSync proporciona 2 potentes herramientas MCP unificadas que combinan la funcionalidad de nuestro sistema anterior de 5 herramientas:

Herramientas universales (todos los planes)

knowsync_query:

• Búsqueda universal y recuperación de contenido con caché inteligente (respuestas 60-85% más rápidas)
• Detección automática de intención (búsqueda vs. recuperación) con expansión y optimización de consultas
• Preservación de contexto consciente de la sesión para consultas de seguimiento con memoria de conversación
• Ajuste inteligente de parámetros basado en clasificación de consultas de IA y puntuación de confianza
• Reordenamiento de resultados impulsado por IA para mejorar la relevancia (planes Pro+)
• Caché de similitud de incrustaciones para consultas repetidas ultrarrápidas

Herramientas de gestión (todos los planes)

knowsync_manage:

• Operaciones integrales de gestión de documentos con seguimiento de uso
• Lista y navegación de documentos con filtrado avanzado y monitoreo de estado (0,5 unidades de API)
• Añade páginas web específicas a tu base de conocimiento con procesamiento vectorial completo (2 unidades de API por URL: 1 rastreo + 1 procesamiento)
• Investiga y descubre contenido web relevante con procesamiento automático (2 unidades de API por URL descubierta)
• Interfaz unificada para todas las operaciones de documentos con seguimiento detallado del consumo de API

Configuración de permisos

Permisos a nivel de herramienta: cada clave de API puede tener acceso a herramientas específicas según tus necesidades:

• Solo búsqueda: ideal para agentes de IA de solo lectura
• Acceso completo: acceso total a todas las herramientas disponibles
• Personalizado: selecciona herramientas específicas para casos de uso especializados

Límite de velocidad: configura límites de solicitudes según los patrones de uso:

• Plan gratuito: máximo 60 solicitudes/hora
• Plan inicial: hasta 600 solicitudes/hora
• Plan profesional: hasta 3,000 solicitudes/hora
• Plan empresarial: límites personalizados disponibles

Integración con herramientas de IA

Configuración de Claude Desktop

Requisitos previos:

• Aplicación Claude Desktop (última versión)
• Clave de API de KnowSync con permisos adecuados
• Identificación de usuario para seguimiento del equipo

Configuración:

1. Obtén la URL de tu servidor: https://www.knowsync.ai/api/mcp
2. Añádela a la configuración de Claude Desktop:

{
  "mcpServers": {
    "knowsync": {
      "url": "https://www.knowsync.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY",
        "X-User-Id": "your_user_id_here"
      }
    }
  }
}

Integración con el IDE Cursor

Instrucciones de configuración:

1. Abre la configuración de Cursor (Cmd/Ctrl + ,)
2. Navega a la sección MCP
3. Añade el servidor de KnowSync:

{
  "mcpServers": {
    "knowsync": {
      "url": "https://www.knowsync.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY",
        "X-User-Id": "your_user_id_here"
      }
    }
  }
}

Integración con VS Code

Uso de la extensión MCP:

1. Instala la extensión MCP para VS Code
2. Configúrala en settings.json:

{
  "mcp.servers": {
    "knowsync": {
      "url": "https://www.knowsync.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY",
        "X-User-Id": "your_user_id_here"
      }
    }
  }
}

Configuración de Claude Code

Requisitos previos:

• CLI de Claude Code instalado (instala mediante npm install -g @anthropic-ai/claude-code o sigue la guía de instalación oficial)
• Clave de API de KnowSync con permisos adecuados
• Tu ID de usuario/correo de KnowSync (se encuentra en la configuración del perfil)

Configuración:

1. Añade el servidor MCP de KnowSync usando la CLI de Claude:

• con ID de usuario:

claude mcp add --transport http knowsync https://www.knowsync.ai/api/mcp \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "X-User-Id: your_user_id_here"

• con correo de usuario:

claude mcp add --transport http knowsync https://www.knowsync.ai/api/mcp \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "X-User-Email: your_user_email_here"

2. Verifica la configuración:

claude mcp list

Esto debería mostrar el servidor knowsync en la lista.

Nota: asegúrate de que tu clave de API tenga los permisos de herramienta necesarios. Reemplaza los marcadores de posición con valores reales.

Seguimiento de miembros del equipo

Encabezados requeridos: todas las solicitudes MCP deben incluir identificación de usuario para una atribución adecuada:

• X-User-Id: tu ID de usuario de KnowSync (se encuentra en la configuración del perfil)
• X-User-Email: tu dirección de correo registrada

Por qué es necesario:

• Rastrear el uso individual de los miembros del equipo
• Generar análisis e información por usuario
• Garantizar pistas de auditoría adecuadas
• Habilitar facturación y límites basados en el uso

Ejemplos de uso de MCP en el mundo real

Integración en el flujo de trabajo de desarrollo

Escenario 1: Asistente de revisión de código

Caso de uso: el agente de IA ayuda durante las revisiones de código accediendo a los estándares de codificación y mejores prácticas de tu equipo.

# Query for coding standards
curl -X POST https://www.knowsync.ai/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-User-Id: your_user_id" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "knowsync_query",
      "arguments": {
        "query": "What are our React component naming conventions and prop validation requirements?",
        "mode": "retrieve",
        "limit": 4
      }
    }
  }'

Integración con agentes de IA: configura Claude Code para usar esto y tener acceso instantáneo a los estándares de tu equipo durante el desarrollo.

Escenario 2: Incorporación de nuevos miembros al equipo

Caso de uso: puebla automáticamente la base de conocimiento con la documentación más reciente del framework para nuevos empleados.

# Discover and add latest documentation
curl -X POST https://www.knowsync.ai/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-User-Id: your_user_id" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "knowsync_manage",
      "arguments": {
        "operation": "discover",
        "query": "Next.js 15 App Router migration guide 2024",
        "options": {
          "maxResults": 8,
          "maxUrls": 4,
          "relevanceThreshold": 0.8
        }
      }
    }
  }'

Respuesta esperada con consumo de API:

{
  "success": true,
  "documentsCreated": 4,
  "apiUnitsConsumed": 8,
  "message": "Successfully discovered and processed 4 documents into knowledge base (8 API units consumed)"
}

Nota: 4 URL × 2 unidades cada una (1 rastreo + 1 procesamiento) = 8 unidades de API en total

Mejora del soporte al cliente

Escenario 3: Acceso instantáneo a la documentación de soporte

Caso de uso: los agentes de soporte obtienen respuestas instantáneas de la documentación del producto mientras ayudan a los clientes.

# Search for troubleshooting information
curl -X POST https://www.knowsync.ai/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-User-Id: support_agent_123" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "knowsync_query",
      "arguments": {
        "query": "Customer getting 401 errors during payment processing, what are the common causes and solutions?",
        "mode": "auto",
        "limit": 6
      }
    }
  }'

Beneficios: tiempo de respuesta 60-85% más rápido gracias al caché, el ranking de relevancia mejorado por IA muestra primero las soluciones más útiles.

Flujos de trabajo de gestión de productos

Escenario 4: Investigación de análisis competitivo

Caso de uso: los gerentes de producto investigan las características de la competencia y las tendencias de la industria.

# Discover latest competitive analysis
curl -X POST https://www.knowsync.ai/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-User-Id: product_manager" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 4,
    "method": "tools/call",
    "params": {
      "name": "knowsync_manage",
      "arguments": {
        "operation": "discover",
        "query": "SaaS pricing strategy trends 2024 freemium models",
        "options": {
          "maxResults": 10,
          "maxUrls": 5,
          "relevanceThreshold": 0.7
        }
      }
    }
  }'

Escenario 5: Búsqueda de requisitos de características

Caso de uso: encuentra rápidamente especificaciones y requisitos de características existentes durante la planificación.

# Search existing requirements
curl -X POST https://www.knowsync.ai/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-User-Id: product_manager" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 5,
    "method": "tools/call",
    "params": {
      "name": "knowsync_query",
      "arguments": {
        "query": "user authentication flow requirements two-factor authentication implementation",
        "mode": "retrieve",
        "filters": {
          "contentTypes": ["documents"],
          "documentIds": ["spec_docs_collection"]
        }
      }
    }
  }'

Soporte de ventas y marketing

Escenario 6: Habilitación de ventas

Caso de uso: el equipo de ventas accede a información del producto y posicionamiento competitivo durante las llamadas con clientes.

# Quick product feature lookup
curl -X POST https://www.knowsync.ai/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-User-Id: sales_rep" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 6,
    "method": "tools/call",
    "params": {
      "name": "knowsync_query",
      "arguments": {
        "query": "What security certifications do we have? SOC 2 compliance status enterprise security features",
        "mode": "search",
        "limit": 5
      }
    }
  }'

Mantenimiento de la base de conocimiento

Escenario 7: Análisis de brechas de contenido

Caso de uso: identifica qué documentación existe y qué necesita crearse.

# Audit existing documentation
curl -X POST https://www.knowsync.ai/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-User-Id: content_manager" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 7,
    "method": "tools/call",
    "params": {
      "name": "knowsync_manage",
      "arguments": {
        "operation": "list",
        "filters": {
          "limit": 50,
          "status": "ready",
          "contentType": "markdown"
        }
      }
    }
  }'

Escenario 8: Añadir documentación de la industria

Caso de uso: mantén la base de conocimiento actualizada con los últimos estándares y marcos de la industria.

# Add specific technical documentation
curl -X POST https://www.knowsync.ai/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-User-Id: tech_writer" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 8,
    "method": "tools/call",
    "params": {
      "name": "knowsync_manage",
      "arguments": {
        "operation": "crawl",
        "url": "https://nextjs.org/docs/app/building-your-application/authentication",
        "options": {
          "respectRobots": true,
          "timeout": 45,
          "followLinks": false
        }
      }
    }
  }'

Por qué KnowSync MCP es revolucionario

La diferencia de poder

Los sistemas de documentación tradicionales te hacen buscar información. KnowSync MCP hace que la información llegue a ti:

Antes de KnowSync MCP:

• Cambiar entre herramientas para buscar documentación
• Repetir búsquedas para preguntas similares
• Unir manualmente información de múltiples fuentes
• Esperar 2-5 segundos por búsqueda
• Obtener resultados que pueden o no ser relevantes

Con KnowSync MCP:

• Los agentes de IA acceden automáticamente a tu base de conocimiento
• Respuestas 60-85% más rápidas mediante caché inteligente
• La IA entiende el contexto y proporciona exactamente lo que necesitas
• La memoria de sesión mantiene el contexto de la conversación
• Resultados clasificados por IA para máxima relevancia

Impacto real en tu flujo de trabajo

# Traditional approach: Manual search in documentation
# Time: 2-5 minutes per question
# Result: May not find the right answer

# KnowSync MCP approach: AI agent instantly knows
# Time: 2-5 seconds per question
# Result: Contextual, accurate, source-cited answers

Ejemplo: un desarrollador que pregunta "¿Cómo manejamos la autenticación?" obtiene no solo los documentos de autenticación, sino específicamente las secciones relevantes para el contexto de su proyecto actual, con sugerencias de seguimiento, en menos de 2 segundos.

Patrones avanzados de integración

Conversaciones conscientes de la sesión

La IA recuerda el contexto entre consultas en la misma sesión, lo que permite preguntas de seguimiento naturales:

# First query
curl -X POST https://www.knowsync.ai/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-User-Id: developer_session_123" \
  -d '{
    "params": {
      "name": "knowsync_query",
      "arguments": {
        "query": "How do we handle user authentication in our React apps?"
      }
    }
  }'

# Follow-up query (AI maintains context)
curl -X POST https://www.knowsync.ai/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-User-Id: developer_session_123" \
  -d '{
    "params": {
      "name": "knowsync_query",
      "arguments": {
        "query": "What about logout and session management for that?"
      }
    }
  }'

Ejemplos de optimización de rendimiento

Demuestra el poder del caché inteligente:

# First time query (full processing)
time curl -X POST https://www.knowsync.ai/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-User-Id: your_user_id" \
  -d '{
    "params": {
      "name": "knowsync_query",
      "arguments": {
        "query": "deployment pipeline configuration Docker containerization"
      }
    }
  }'
# Response time: ~800ms

# Similar query (cached response)
time curl -X POST https://www.knowsync.ai/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-User-Id: your_user_id" \
  -d '{
    "params": {
      "name": "knowsync_query",
      "arguments": {
        "query": "how to configure deployment pipelines with Docker containers"
      }
    }
  }'
# Response time: ~120ms (85% faster!)

Transforma la productividad de tu equipo

Antes vs. Después de KnowSync MCP

| Escenario | Método tradicional | Con KnowSync MCP | Tiempo ahorrado | |----------|-------------------|-------------------|------------| | Revisión de código | Buscar en documentos manualmente | El agente de IA cita instantáneamente los estándares de codificación | 90% más rápido | | Soporte al cliente | Consultar guías de solución de problemas | La IA proporciona pasos exactos de solución | 85% más rápido | | Incorporación | Enviar enlaces a la documentación | La IA responde preguntas específicas contextualmente | 95% más rápido | | Planificación de productos | Investigar características de la competencia manualmente | La IA descubre y analiza las últimas tendencias | 80% más rápido |

El efecto compuesto

Semana 1: tu equipo ahorra 2-3 horas al día en búsquedas de documentación Mes 1: 40-60 horas ahorradas por miembro del equipo Año 1: cada miembro del equipo recupera 2-3 semanas de tiempo productivo

Historias reales de impacto de usuarios

Equipo de desarrollo: "En lugar de pasar 30 minutos buscando nuestros patrones de API, Claude Code me muestra instantáneamente exactamente lo que necesito. Puedo concentrarme en construir en lugar de buscar."

Equipo de soporte: "Las preguntas de los clientes que solían tomar 10 minutos de investigación ahora se responden en 30 segundos. Nuestra calidad de respuesta mejoró mientras que nuestro tiempo de respuesta cayó drásticamente."

Equipo de producto: "La investigación que solía tomar horas ahora ocurre en minutos. Podemos analizar características competitivas, encontrar requisitos y tomar decisiones más rápido que nunca."

Comenzar es simple

1. Crea una clave de API (2 minutos)
2. Conecta tu agente de IA (Claude, Cursor, VS Code)
3. Empieza a hacer preguntas - ¡eso es todo!

El poder no está en la tecnología, sino en cómo transforma tu trabajo diario de buscar a crear.

Análisis de uso y monitoreo

Características del panel MCP

Gestión de claves de API:

• Crear, editar y eliminar claves de API
• Monitorear estadísticas de uso por clave
• Configurar permisos y límites de velocidad
• Ver historial de solicitudes y patrones

Análisis de uso:

• Métricas de solicitudes en tiempo real por herramienta
• Tasas de éxito/error y tiempos de respuesta
• Atribución por usuario y perspectivas del equipo
• Tendencias históricas y patrones de uso

Configuración de ajustes:

• Límites de rastreo web y configuraciones de tiempo de espera
• Listas de permitidos/bloqueados de dominios para descubrimiento web
• Preferencias de filtrado por tipo de contenido
• Límites de velocidad y controles de seguridad

Seguimiento de uso del equipo

Análisis individual:

• Rastrear qué miembros del equipo usan herramientas MCP
• Monitorear patrones de adopción en toda la organización
• Identificar usuarios avanzados y necesidades de capacitación
• Generar informes de uso para la gerencia

Atribución de solicitudes: todas las solicitudes MCP requieren encabezados de identificación de usuario:

• X-User-Id: atribución directa por ID de usuario
• X-User-Email: atribución de usuario basada en correo
• Las solicitudes sin encabezados de usuario son rechazadas
• Pista de auditoría completa para cumplimiento

Seguridad y control de acceso

Sistema de autenticación

Seguridad de claves de API:

• Hash Bcrypt para claves almacenadas
• Capacidades automáticas de rotación de claves
• Límite de velocidad por clave para prevenir abuso
• Monitoreo en tiempo real de actividad sospechosa

Modelo de permisos:

• Permisos a nivel de herramienta (control de acceso granular)
• Restricciones de acceso basadas en organización
• Disponibilidad de características según plan
• Combinaciones de permisos personalizados

Seguridad empresarial (planes Enterprise)

Características avanzadas:

• Restricciones de acceso basadas en IP
• Integración de inicio de sesión único (SSO)
• Registros de auditoría para requisitos de cumplimiento
• Políticas y controles de seguridad personalizados

Protección de datos:

• Cifrado TLS para todas las comunicaciones
• Almacenamiento seguro de claves API y datos de usuario
• Funciones de cumplimiento de GDPR y CCPA
• Auditorías y actualizaciones de seguridad periódicas

Solución de problemas

Problemas comunes

Problemas de conexión:

• Error: El agente de IA no puede conectarse al servidor MCP
• Soluciones:
  • Verifica que la clave API sea correcta y no haya caducado
    • Confirma que la URL de tu dominio sea accesible (no localhost para herramientas remotas)
    • Comprueba que se incluyan los encabezados de identificación de usuario
    • Revisa los permisos de la clave API para las herramientas requeridas

Errores de autenticación:

• Error: "No autorizado" o "Se requiere identificación de usuario"
• Soluciones:
  • Incluye el encabezado X-User-Id o X-User-Email en todas las solicitudes
    • Verifica que el ID/correo del usuario exista en tu organización
    • Regenera la clave API si es necesario
    • Comprueba que la clave API tenga los permisos de herramienta adecuados

Límite de velocidad:

• Error: "Límite de velocidad excedido"
• Soluciones:
  • Revisa el uso actual en el panel de MCP
    • Ajusta los límites de velocidad para tu clave API
    • Considera actualizar tu plan para obtener límites más altos
    • Implementa limitación de solicitudes en tu aplicación

Errores de permisos de herramientas:

• Error: "Permiso denegado para la herramienta X"
• Soluciones:
  • Edita los permisos de la clave API en el panel de MCP
    • Asegúrate de que tu plan incluya acceso a herramientas avanzadas
    • Contacta con soporte para limitaciones específicas del plan

Prueba de tu servidor MCP

Verificación de estado:

# Test server connectivity
curl https://www.knowsync.ai/api/mcp

# Expected response includes server info and available tools

Prueba de herramientas:

# Test initialize method
curl -X POST https://www.knowsync.ai/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-User-Id: your_user_id" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2024-11-05",
      "capabilities": {"tools": true},
      "clientInfo": {"name": "test-client", "version": "1.0.0"}
    }
  }'

Futuras herramientas MCP

KnowSync está desarrollando activamente herramientas MCP adicionales planificadas para 2025:

Fase 1 (Q1 2025):

• knowsync_summarize: Genera resúmenes inteligentes de documentos
• knowsync_bulk_operations: Realiza operaciones por lotes en múltiples documentos
• knowsync_compare: Compara documentos para identificar similitudes y diferencias

Fase 2 (Q2 2025):

• knowsync_analytics: Obtén información de uso y análisis de la base de conocimiento
• knowsync_quality_check: Analiza y mejora la calidad del contenido

Consulta nuestra Hoja de ruta de herramientas MCP para obtener detalles completos.

Obtención de soporte

Documentación:

• Guía completa de pruebas de MCP con ejemplos reales
• Documentación de referencia de API para todas las herramientas
• Guías de integración para plataformas de IA populares

Canales de soporte:

• Starter/Professional: Soporte por correo electrónico con experiencia en MCP
• Enterprise: Soporte dedicado de integración MCP
• Todos los planes: Foros comunitarios y documentación

Integración personalizada: Los clientes Enterprise pueden trabajar con nuestro equipo para el desarrollo de herramientas MCP personalizadas y patrones de integración avanzados.

🚀 ¿Listo para conectar tus herramientas de IA?

Comienza creando tu primera clave API en el panel de MCP y luego prueba la conexión con una consulta de búsqueda simple. Recuerda incluir encabezados de identificación de usuario para una atribución adecuada del equipo.