> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hiveku.com/llms.txt
> Use this file to discover all available pages before exploring further.

# LLM Connectors (MCP)

> Connect ChatGPT, Claude, or other AI clients to your Hiveku account via the Model Context Protocol (MCP)

## Overview

Hiveku exposes a **Model Context Protocol (MCP)** server so you can manage your Hiveku account directly from ChatGPT, Claude, Claude Desktop, or Claude Code. Once connected, you can ask your LLM to create content, check analytics, manage projects, and more — all in natural language.

<Info>
  **What is MCP?** The Model Context Protocol is an open standard from Anthropic that lets AI assistants securely access external tools and data. Hiveku's MCP server implements this standard so any MCP-compatible client can connect.
</Info>

## How it works

1. You create an **API key** in Hiveku (one per LLM client)
2. You add the Hiveku MCP endpoint to your LLM client's connector settings
3. Your LLM can now use Hiveku tools scoped to your account — create projects, manage content, read analytics, etc.
4. All tool calls are authenticated with your API key, rate-limited, and logged for security auditing

## Endpoints

| Client             | Endpoint                       | Transport          |
| ------------------ | ------------------------------ | ------------------ |
| Claude (claude.ai) | `https://core.hiveku.com/mcp`  | Streamable HTTP    |
| Claude Desktop     | `https://core.hiveku.com/mcp`  | Streamable HTTP    |
| Claude Code        | `https://core.hiveku.com/mcp`  | Streamable HTTP    |
| ChatGPT            | `https://core.hiveku.com/sse/` | Server-Sent Events |

Authentication is via Bearer token in the `Authorization` header.

## Create an API Key

<Steps>
  <Step title="Open LLM Connectors">
    In your Hiveku dashboard, go to **Settings** and scroll to the **LLM Connectors** section.
  </Step>

  <Step title="Create a key">
    Click **Create API Key**, enter a descriptive name (e.g., "My ChatGPT", "Office Claude"), and click **Generate Key**.
  </Step>

  <Step title="Copy the key">
    Your full API key is shown **only once** at creation. It looks like:

    ```
    hvk_a1b2c3d4e5f6...
    ```

    Copy it now — you won't be able to see it again. If you lose it, deactivate the key and create a new one.
  </Step>
</Steps>

<Warning>
  Treat API keys like passwords. Never commit them to source control or share them publicly. Each key has access to your entire Hiveku account.
</Warning>

## Setup by Client

<Tabs>
  <Tab title="Claude (claude.ai)">
    <Steps>
      <Step title="Open Claude settings">
        Go to [claude.ai/settings](https://claude.ai/settings).
      </Step>

      <Step title="Add a connector">
        Click **Connectors** in the sidebar, then click **Add custom connector**.
      </Step>

      <Step title="Paste the URL">
        Paste the Hiveku MCP URL and click **Add**:

        ```
        https://core.hiveku.com/mcp
        ```
      </Step>

      <Step title="Authenticate">
        You'll see a Hiveku login page. Paste your API key from the dashboard.
      </Step>

      <Step title="Start using it">
        Open a new chat — your Hiveku tools will appear automatically.
      </Step>
    </Steps>
  </Tab>

  <Tab title="ChatGPT">
    <Steps>
      <Step title="Open ChatGPT Settings">
        Go to **Settings > Connectors**.
      </Step>

      <Step title="Enable Developer Mode">
        In **Advanced settings**, enable **Developer Mode**.
      </Step>

      <Step title="Create a connector">
        Click **Create** and name it "Hiveku". Paste the SSE URL:

        ```
        https://core.hiveku.com/sse/
        ```
      </Step>

      <Step title="Set authentication">
        Set **Authentication** to **OAuth**. You'll see a Hiveku login page — paste your API key.
      </Step>

      <Step title="Enable in chat">
        In any chat, click **+ > More > Developer Mode** to enable the Hiveku connector.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Claude Desktop">
    <Steps>
      <Step title="Open the config file">
        In Claude Desktop, click the settings gear icon, then **Developer > Edit Config**.
      </Step>

      <Step title="Add the Hiveku server">
        Paste the following into your config file, replacing `hvk_your_key_here` with your actual API key:

        ```json theme={null}
        {
          "mcpServers": {
            "hiveku": {
              "url": "https://core.hiveku.com/mcp",
              "headers": {
                "Authorization": "Bearer hvk_your_key_here"
              }
            }
          }
        }
        ```
      </Step>

      <Step title="Restart Claude Desktop">
        Save the file and restart Claude Desktop. Your Hiveku tools will appear automatically.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Claude Code">
    Run this command in your terminal, replacing `hvk_your_key_here` with your actual API key:

    ```bash theme={null}
    claude mcp add hiveku \
      --transport streamable-http \
      --header "Authorization: Bearer hvk_your_key_here" \
      https://core.hiveku.com/mcp
    ```

    Hiveku tools will now be available in Claude Code sessions.
  </Tab>
</Tabs>

## What Your LLM Can Do

Once connected, you can ask your LLM to perform actions across Hiveku in plain language. Capabilities are scoped to your account.

<CardGroup cols={2}>
  <Card title="Projects" icon="folder">
    Create and manage website projects, check deployment status, switch between projects
  </Card>

  <Card title="Content & Pages" icon="file-lines">
    Create, read, update, and delete website pages, blog posts, and content
  </Card>

  <Card title="CRM" icon="users">
    Search contacts, manage pipeline stages, look up leads and deals
  </Card>

  <Card title="Marketing" icon="megaphone">
    Schedule social posts, manage email campaigns, generate content drafts
  </Card>

  <Card title="Analytics" icon="chart-line">
    Query visitor analytics, traffic data, and performance metrics
  </Card>

  <Card title="Workflows" icon="gear">
    List, trigger, and inspect automation workflows
  </Card>
</CardGroup>

### Example Prompts

Try asking your LLM things like:

* *"List all my Hiveku projects and their deployment status"*
* *"Create a new blog post titled 'Welcome to our new site' in my main project"*
* *"How many visitors did my site get last week?"*
* *"Add a new contact to CRM: Jane Doe, [jane@acme.com](mailto:jane@acme.com), Acme Inc"*
* *"Schedule a LinkedIn post for tomorrow at 9am about our new feature"*
* *"Deploy my project to production"*

## Managing Keys

### Rotate a key

Create a new key with a descriptive name, update your LLM client to use the new key, then deactivate the old one.

### Deactivate a key

From **Settings > LLM Connectors**, click the trash icon next to any key to deactivate it. Deactivated keys immediately stop working — any LLM using that key will lose access until a new key is provided.

<Tip>
  Use separate keys for each LLM client (one for ChatGPT, one for Claude Desktop, etc.) so you can rotate them independently and see which client is making requests in the "Last used" column.
</Tip>

## Security & Limits

* **Rate limit:** 100 requests per minute per key
* **Scoping:** Keys are scoped to your Hiveku account — they cannot access other accounts
* **Audit log:** Every tool call is logged with timestamp, action, and client
* **Key format:** Keys are 64-character hex strings prefixed with `hvk_`
* **Storage:** Keys are stored hashed. The full value is shown only once at creation.
* **Revocation:** Deactivated keys stop working immediately

<Warning>
  If you suspect a key has been compromised (leaked in a log, committed to a repo, shared in a screenshot), deactivate it immediately and create a new one.
</Warning>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Claude can't find Hiveku tools">
    * Verify the connector is enabled in your Claude settings
    * Check that your API key hasn't been deactivated in the Hiveku dashboard
    * Try restarting your Claude client
    * Test with a simple prompt like "What Hiveku projects do I have?"
  </Accordion>

  <Accordion title="ChatGPT connector shows authentication error">
    * Make sure Developer Mode is enabled in ChatGPT's advanced settings
    * Verify you used the SSE URL (`https://core.hiveku.com/sse/`) not the MCP URL
    * Create a fresh API key and re-authenticate
  </Accordion>

  <Accordion title="Getting rate limit errors">
    The default limit is 100 requests/min per key. If you hit this, wait 60 seconds. For higher limits, contact support.
  </Accordion>

  <Accordion title="Key not working after creation">
    Make sure you copied the full key (starts with `hvk_`). If you only see a preview like `hvk_a1b2c3...x9y8`, that's the display shortcut — you needed to copy the full version at the moment of creation. Create a new key and copy it immediately.
  </Accordion>
</AccordionGroup>