Skip to main content

Setup Guide

There's nothing to install. You add the connector by URL and sign in with your normal Kula account.

Before you start​

  • A Kula account on your company's workspace (for example, acme.kula.ai).
  • A paid Claude plan — Pro, Max, Team, or Enterprise. Custom connectors aren't available on the free plan.

Connect​

  1. In Claude, open Settings → Connectors.

  2. Click Add custom connector.

  3. Give it a name (for example, "Kula") and enter the URL:

    https://mcp.kula.ai/mcp

  4. Click Add. Claude opens the Kula sign-in page.

  5. Enter your account URL — your workspace subdomain (acme) is enough — and sign in.

  6. Review the access on the consent screen and click Allow Access.

That's it. Claude keeps you signed in and refreshes access on its own, so you won't repeat this.

Using it​

Ask for what you want in plain language:

List the open jobs in Engineering and the newest applications for each.

Claude chooses the tools. Lookups and searches run on their own; anything that changes data — adding a note, moving a stage, scheduling or cancelling an interview — asks you to confirm first. You can change what needs approval per tool under the connector in Settings → Connectors.

What the connector can access​

It acts as you. It has your Kula role and permissions and nothing more, so it can't reach records or actions you can't. Access uses OAuth — Claude never gets your password or a long-lived key.

Other MCP clients​

The connector is a standard remote MCP server, so it isn't limited to Claude. Point any MCP client that supports remote servers with OAuth at the same URL, https://mcp.kula.ai/mcp. If your client isn't working, contact Kula support.

Disconnect​

Open the Kula connector in Settings → Connectors and click Disconnect. This revokes Claude's access right away.

Local server (self-hosted)​

The hosted connector above is recommended. If you'd rather run the server yourself — or need it in a setup that suits a local process — the @kula-ai/mcp-server package runs on your machine and authenticates with a Kula API key instead of OAuth. It acts with whatever the API key is scoped to, not a specific signed-in user.

Prerequisites: Node.js 22+ and a Kula API key (Settings → API Management → Authentication).

Claude Desktop — add to your config file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows), then restart Claude:

{
  "mcpServers": {
    "kula": {
      "command": "npx",
      "args": ["-y", "@kula-ai/mcp-server"],
      "env": { "KULA_API_KEY": "your_api_key_here" }
    }
  }
}

Cursor — add the same block to .cursor/mcp.json in your project root.

Claude Code — run:

claude mcp add kula -- npx -y @kula-ai/mcp-server
export KULA_API_KEY="your_api_key_here"