COFA Probe MCP Bridge

stdio MCP bridge for importing AI tool transcripts into COFA Probe.

MCP Host Config

{
  "mcpServers": {
    "cofa-probe": {
      "command": "npx",
      "args": ["-y", "@cofa-probe/mcp-bridge@latest"],
      "env": {
        "PROBE_MCP_BASE_URL": "https://cofa-probe-dev.krafton.ai",
        "PROBE_MCP_ACCESS_ID": "cand_...",
        "PROBE_MCP_SESSION_ID": "..."
      }
    }
  }
}

Tools

• probe_mcp_ping: checks whether the configured session accepts MCP imports.
• probe_import_messages: imports structured conversation messages.

The bridge uploads content to /api/mcp/import. It does not read the host app's full conversation database by itself; MCP hosts must call probe_import_messages with message text and the original timestamp for every message.

probe_import_messages requires this shape:

{
  "messages": [
    {
      "role": "user",
      "text": "오늘 날씨 어때 1",
      "timestamp": "2026-05-15T05:46:05.000Z"
    },
    {
      "role": "assistant",
      "text": "어느 지역인가요?",
      "timestamp": "2026-05-15T05:46:08.000Z",
      "modelId": "claude-sonnet-4-6"
    }
  ],
  "externalThreadId": "optional-source-thread-id"
}

Plain text transcript import is intentionally not exposed. If a host cannot provide per-message timestamps, it should not import that conversation through this bridge.

Before every import, the bridge calls probe_mcp_ping and estimates the clock offset between the MCP host and the Probe server using the ping round-trip midpoint. It sends calibrated message timestamps plus this metadata:

{
  "clockCalibration": {
    "method": "ping-midpoint-v1",
    "clientStartedAt": "2026-05-15T05:46:10.100Z",
    "clientFinishedAt": "2026-05-15T05:46:10.180Z",
    "clientMidpointAt": "2026-05-15T05:46:10.140Z",
    "serverCheckedAt": "2026-05-15T05:46:10.150Z",
    "roundTripMs": 80,
    "estimatedOffsetMs": 10
  }
}

Each message keeps originalTimestamp and sends timestamp after calibration.

PROBE_MCP_BASE_URL is required and must use HTTPS. http://localhost is accepted only for local development.

On macOS, the bridge loads certificates from the system and login keychains in addition to Node's bundled CA list. This lets managed company devices reuse their installed corporate root CA without adding certificate paths to the MCP host config. PROBE_MCP_CA_CERTS can point to a PEM bundle for local debugging.

PROBE_MCP_TOOL is optional. Leave it unset for the generic MCP host parser, or set it to cursor, claude_desktop, or cline only when uploading one of those app-specific raw log formats.