tacit-mcp

Servidor MCP que conecta asistentes de IA a los gemelos digitales de edificios de Tacit. Haz preguntas sobre tus edificios, equipos, sensores y zonas en lenguaje natural.

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

Qué hace

Cuatro herramientas de solo lectura:

La herramienta GraphQL incluye la referencia completa del esquema, por lo que el modelo de IA puede redactar consultas sin necesidad de documentación adicional.

Inicio rápido

Opción A: npx (recomendado — no requiere instalación)

npx -y @tacit/mcp-server

Simplemente apunta tu cliente MCP hacia él (consulta la configuración a continuación). Sin clonar, sin compilar.

Opción B: Clonar y compilar

git clone https://github.com/ucl-sbde/tacit-mcp.git
cd tacit-mcp
npm install
npm run build

Necesitarás una clave API de Tacit. Consigue una en tu panel de control en app.betacit.com bajo Site Settings > API Keys.

Métodos de conexión

1. Transporte Stdio (local, predeterminado)

El método estándar: el cliente MCP inicia el servidor como un proceso hijo. Ideal para uso individual en tu propia máquina.

Claude Desktop

Edita ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "tacit": {
      "command": "npx",
      "args": ["-y", "@tacit/mcp-server"],
      "env": {
        "TACIT_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Code

Añade a .mcp.json en tu proyecto:

{
  "mcpServers": {
    "tacit": {
      "command": "npx",
      "args": ["-y", "@tacit/mcp-server"],
      "env": {
        "TACIT_API_KEY": "your-api-key"
      }
    }
  }
}

Cursor

Añade a .cursor/mcp.json:

{
  "mcpServers": {
    "tacit": {
      "command": "npx",
      "args": ["-y", "@tacit/mcp-server"],
      "env": {
        "TACIT_API_KEY": "your-api-key"
      }
    }
  }
}

2. Transporte HTTP transmitible (remoto)

Ejecuta el servidor como un servicio HTTP persistente. Ideal para equipos, despliegues en la nube y entornos donde los usuarios no pueden instalar Node.js localmente.

# Start the HTTP server
TACIT_API_KEY=your-api-key npm run start:http

# Or with npx
TACIT_API_KEY=your-api-key npx --package @tacit/mcp-server tacit-mcp-http

El servidor escucha en http://0.0.0.0:3001/mcp por defecto.

Conectar desde cualquier cliente MCP

Apunta tu cliente a la URL del servidor con un token de portador (bearer token):

{
  "mcpServers": {
    "tacit": {
      "type": "streamable-http",
      "url": "https://your-host:3001/mcp",
      "headers": {
        "Authorization": "Bearer your-api-key"
      }
    }
  }
}

Configuración HTTP

Verificación de estado (Health check)

GET /health → { "status": "ok", "transport": "streamable-http", "sessions": 3 }

3. OAuth 2.1 (empresarial)

Para despliegues en producción donde deseas que los usuarios se autentiquen a través del flujo de inicio de sesión de Tacit en lugar de gestionar claves API:

TACIT_OAUTH_ISSUER=https://app.betacit.com npm run start:http

Esto habilita:

• Registro dinámico de clientes — los clientes MCP se registran automáticamente

• Código de autorización + PKCE — los usuarios inician sesión a través de la interfaz web de Tacit

• Actualización de tokens — las sesiones permanecen activas sin necesidad de reautenticación

• Revocación de tokens — terminación limpia de la sesión

Los clientes MCP que soportan OAuth (como Claude Desktop) descubrirán la configuración de autenticación automáticamente a través del endpoint de metadatos .well-known/oauth-authorization-server.

4. Docker

docker run -p 3001:3001 -e TACIT_API_KEY=your-api-key tacit/mcp-server

Conecta usando la configuración de transporte HTTP anterior.

Pruébalo

Una vez conectado, pregunta a tu asistente de IA cosas como:

• "List all my building sites"

• "What AHUs are in Tower West?"

• "Show me temperature sensors on AHU-001"

• "Get the last 24 hours of supply air temperature data"

• "What equipment feeds the lobby zone?"

Variables de entorno

Desarrollo

npm run dev       # watch mode — stdio transport
npm run dev:http  # watch mode — HTTP transport
npm run build     # compile TypeScript
npm start         # run stdio transport
npm run start:http # run HTTP transport

Licencia

MIT