Bitly MCP Server

Der Bitly MCP Server

Willkommen zum Bitly MCP Server-Leitfaden.

Wenn Sie hier sind, wissen Sie wahrscheinlich bereits, was ein MCP Server ist, aber falls Sie eine Einführung benötigen, schauen Sie sich unsere Seite „Was ist MCP?" an.

Der Bitly MCP Server bietet Zugriff auf die gesamte Funktionalität, die Sie von einer Bitly-Oberfläche erwarten würden – wie die Bitly API, wie die bitly.com-Website, wie die Bitly Chrome Extension, wie die Bitly Mobile App – aber dieses Mal für Ihren KI-Agenten Ihrer Wahl.

Möchten Sie Bitly mit ChatGPT verwenden? Bitly MCP Server oder Bitly Custom GPT. Möchten Sie Bitly mit Claude verwenden? Bitly MCP Server. Möchten Sie Bitly mit Cursor, VSCode oder Windsurf verwenden? Bitly MCP Server.

Schnelleinrichtung

Der Bitly MCP Server wird unter https://api-ssl.bitly.com/v4/mcp. gehostet

Authentifizierungsoptionen:

• OAuth 2.1 (Empfohlen) – Für Clients, die OAuth unterstützen, bietet dies eine sichere, tokenbasierte Authentifizierung mit automatischer Client-Registrierung
• API-Token – Für einfachere Einrichtungen oder Clients ohne OAuth-Unterstützung verwenden Sie Ihr Bitly-API-Token von https://bitly.com/settings/api

Unten finden Sie die Übersicht der Konfigurationen mit Links zu detaillierten Anweisungen – falls eine fehlt, die Sie verwenden, finden Sie Anleitungen auf der Seite „Konfigurationsdetails". Wir werden im Laufe der Zeit weitere Konfigurationsanleitungen hinzufügen.

KI-Agent	Konfigurationsanweisungen	Hinweise
ChatGPT	ChatGPT konfigurieren	OAuth mit dynamischer Client-Registrierung
Claude Web-Oberfläche (claude.ai)	Claude Web konfigurieren	OAuth mit dynamischer Client-Registrierung
Claude Desktop	Claude Desktop konfigurieren	Unterstützt sowohl OAuth als auch API-Token
Claude Code	Claude Code konfigurieren	HTTP-Transport – unterstützt sowohl OAuth als auch API-Token
Cursor	Cursor konfigurieren	HTTP-Transport – unterstützt sowohl OAuth als auch API-Token
VS Code	VS Code konfigurieren	HTTP-Transport – unterstützt sowohl OAuth als auch API-Token
Windsurf	Windsurf konfigurieren	Verwendet npx-Proxy für lokale Verbindung
Die meisten anderen HTTP-kompatiblen Agenten	Siehe unseren Konfigurationsbereich	Generisches HTTP-Setup funktioniert für die meisten

Konfigurationen

Claude Code

Fügen Sie zu ~/.claude/mcp.json hinzu:

Für OAuth (empfohlen):

{
  "mcpServers": {
    "Bitly": {
      "type": "http",
      "url": "https://api-ssl.bitly.com/v4/mcp"
    }
  }
}

Für API-Token:

{
  "mcpServers": {
    "Bitly": {
      "type": "http",
      "url": "https://api-ssl.bitly.com/v4/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_BITLY_AUTH_TOKEN"
      }
    }
  }
}

Starten Sie Claude Code nach dem Hinzufügen der Konfiguration neu.

Cursor

Fügen Sie zu ~/.cursor/mcp.json hinzu:

Starten Sie Cursor nach dem Hinzufügen der Konfiguration neu.

Claude Desktop

Fügen Sie zu Ihrer Claude-Konfigurationsdatei hinzu:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.jsonWindows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "Bitly": {
      "url": "https://api-ssl.bitly.com/v4/mcp"
    }
  }
}

Für API-Token (mit npx-Proxy):

Voraussetzung: Erfordert Node.js 20 LTS oder höher mit npx-Unterstützung.

{
  "mcpServers": {
    "Bitly": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://api-ssl.bitly.com/v4/mcp",
        "--header",
        "Authorization: Bearer ${AUTH_TOKEN}"
      ],
      "env": {
        "AUTH_TOKEN": "YOUR_BITLY_AUTH_TOKEN"
      }
    }
  }
}

Starten Sie Claude Desktop nach dem Hinzufügen der Konfiguration neu.

VS Code

Fügen Sie zu ~/.vscode/mcp.json in Ihrem Arbeitsbereich hinzu:

{
  "servers": {
    "Bitly": {
      "type": "http",
      "url": "https://api-ssl.bitly.com/v4/mcp"
    }
  }
}

{
  "servers": {
    "Bitly": {
      "type": "http",
      "url": "https://api-ssl.bitly.com/v4/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_BITLY_AUTH_TOKEN"
      }
    }
  }
}

Windsurf

Fügen Sie zu ~/.windsurf/config.json hinzu:

### Claude Web

For Claude on the web (claude.ai), use OAuth authentication:

1. Navigate to your Claude workspace settings
2. Go to the MCP servers configuration section
3. Add the Bitly MCP Server:  
   * **Server URL:** `https://api-ssl.bitly.com/v4/mcp`  
   * **Authentication:** OAuth

When prompted, log in to your Bitly account and authorize the connection. Claude will handle the OAuth flow automatically using Dynamic Client Registration.

> **Note:** OAuth support in Claude Web requires Workspace Admin enablement for Team and Enterprise Plans.

### ChatGPT

For ChatGPT, use OAuth authentication:

1. In ChatGPT, go to **Settings > Apps & Connectors > Advanced Settings**
2. Toggle **Developer Mode** on
3. Go back and click **Create**
4. Add the Bitly MCP Server:  
   * **Server URL:** `https://api-ssl.bitly.com/v4/mcp`  
   * **Authentication:** OAuth

When prompted, log in to your Bitly account and authorize the connection. ChatGPT will handle the OAuth flow automatically using Dynamic Client Registration.

> **Note:** MCP support in ChatGPT requires Plus, Team, Enterprise, or Edu plans. For workspace plans, you must be an admin to access these settings.

## Authentication

The Bitly MCP Server supports two authentication methods:

### OAuth 2.1 with Dynamic Client Registration (Recommended)

For clients that support OAuth (like Claude Web, ChatGPT, and other modern AI assistants), OAuth provides:

* **Enhanced Security** \- No need to manually manage API tokens
* **Automatic Client Registration** \- Dynamic Client Registration (DCR) handles client setup automatically
* **Token Refresh** \- Automatic token renewal without manual intervention

When configuring OAuth, your AI client will:

1. Redirect you to Bitly's authorization page
2. Ask you to log in and authorize the connection
3. Automatically register as an OAuth client using DCR
4. Receive and manage access tokens transparently

### API Token (Alternative)

For simpler setups or clients without OAuth support:

1. Log in to your Bitly account at bitly.com
2. Navigate to Settings → API
3. Click Generate Access Token
4. Copy the token and store it securely
5. Use it in your MCP client configuration as shown in the examples above

## Test It Out

Once configured, try asking your AI:

„Welche Bitly-Tools sind verfügbar?"

„Bitte kürzen Sie diese URL: https://example.com/very-long-url"

Von dort aus sollten Sie startklar sein!

---