logggai-mcp/README.md

Generic MCP server for Logggai (multi-IDE, Cursor wrapper, extensible)

# Logggai MCP Server

## Overview

The Logggai MCP Server lets you integrate Logggai with Cursor (and other MCP agents) locally (stdio), providing a native and secure experience.

---

## 🚀 Cursor MCP Onboarding (local)

### 1. Get your Logggai MCP Token
- Get your Unkey API key from the LOGGGAI dashboard at `/api-keys`
- Generate MCP token: `curl -X POST https://logggai.run/api/auth/apikey -H "Authorization: Bearer YOUR_UNKEY_API_KEY"`
- Copy the `access_token` from the response

### 2. Add Logggai to Cursor
- Click the “Add to Cursor” button on the Logggai website **or**
- Manually add to your `.cursor/mcp.json`:
  ```json
  {
    "mcpServers": {
      "logggai": {
        "command": "node",
        "args": ["/path/to/logggai-mcp/index.js"],
        "env": {
          "API_KEY": "your_jwt_mcp_token_here"
        }
      }
    }
  }
  ```

### 3. Run the MCP server locally (via npm)
- Prerequisite: Node.js and npm installed
- The MCP server will be launched automatically by Cursor via `npx logggai-mcp` (no need to run it manually)
- If needed, you can run it manually:
  ```bash
  npx logggai-mcp
  ```

### 4. Authentication Details
- The server uses JWT MCP tokens generated from Unkey API keys
- Process: Unkey API Key → JWT MCP Token (via `/api/auth/apikey`) → `API_KEY` env var
- JWT tokens have specific claims:
  - **Audience**: `logggai-mcp`
  - **Issuer**: `logggai`
  - **Scopes**: `["agent"]`
  - **Algorithm**: RS256
- All Logggai tools are available in Cursor (sync_commits, create_post, etc.)
- Security is ensured by JWT signature verification

### 5. Deeplink synchronization
- If you publish a new npm version or change the config, rerun the deeplink generation script to update the “Add to Cursor” button

### 6. Official documentation
- [Cursor MCP servers documentation](https://docs.cursor.com/tools/mcp)

---

*Made with ❤️ by Thibault Souris & EDEN*

## License
MIT