Quick Start

Get started in 5 minutes

Create new organization and connect

Install the Gatana skill (recommended):

npx skills add gatana-ai/gatana

Then ask your agent:

Create a Gatana organization and connect this computer to it

Without installing skill:

Follow https://www.gatana.ai/llms.txt to create a Gatana organization and connect this computer to it

Skill source: https://github.com/gatana-ai/gatana/tree/main/skills/gatana.

curl -fsSL https://github.com/gatana-ai/gatana/releases/latest/download/install.sh | sh
gatana signup
gatana install
brew install gatana-ai/tap/gatana
gatana signup
gatana install
  1. Go to https://hello.gatana.ai/signup
  2. Create your organization

Install into harness

claude mcp add --transport http --scope user gatana https://gatana.ai/mcp
claude mcp login gatana
codex mcp add gatana --url https://gatana.ai/mcp
codex mcp login gatana

Codex in the terminal, the IDE extension and the desktop app will all get Gatana.

Add this to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "gatana": { "type": "http", "url": "https://gatana.ai/mcp" }
  }
}

Cursor asks you to sign in the first time it connects.

Add this to .vscode/mcp.json in your workspace:

{
  "servers": {
    "gatana": { "type": "http", "url": "https://gatana.ai/mcp" }
  }
}

VS Code asks you to sign in the first time it starts the server.

hermes mcp add gatana --url https://gatana.ai/mcp --auth oauth

If Hermes is running, run /reload-mcp. You do not have to restart it.

Add this to ~/.openclaw/openclaw.json:

{
  "mcp": {
    "servers": {
      "gatana": { "url": "https://gatana.ai/mcp", "transport": "streamable-http" }
    }
  }
}

Most clients take this shape:

{
  "mcpServers": {
    "gatana": { "type": "http", "url": "https://gatana.ai/mcp" }
  }
}

A client that only asks for a URL takes https://gatana.ai/mcp. The client signs in over OAuth. A client that cannot do OAuth needs a personal access token.

Note: this does not install the skills, for that you need to use the Gatana CLI


Connect to an existing organization

On-Premise or Self-Hosted?

Add --base-url https://your-gatana.corpo.acme to all Gatana CLI commands.

Install the Gatana skill (recommended):

npx skills add gatana-ai/gatana

Then ask your agent:

Connect this computer to Gatana

Without installing skill:

Follow https://www.gatana.ai/llms.txt and connect this computer to Gatana

Skill source: https://github.com/gatana-ai/gatana/tree/main/skills/gatana.

curl -fsSL https://github.com/gatana-ai/gatana/releases/latest/download/install.sh | sh
gatana install
brew install gatana-ai/tap/gatana
gatana install

Install into harness

claude mcp add --transport http --scope user gatana https://gatana.ai/mcp
claude mcp login gatana
codex mcp add gatana --url https://gatana.ai/mcp
codex mcp login gatana

Codex in the terminal, the IDE extension and the desktop app will all get Gatana.

Add this to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "gatana": { "type": "http", "url": "https://gatana.ai/mcp" }
  }
}

Cursor asks you to sign in the first time it connects.

Add this to .vscode/mcp.json in your workspace:

{
  "servers": {
    "gatana": { "type": "http", "url": "https://gatana.ai/mcp" }
  }
}

VS Code asks you to sign in the first time it starts the server.

hermes mcp add gatana --url https://gatana.ai/mcp --auth oauth

If Hermes is running, run /reload-mcp. You do not have to restart it.

Add this to ~/.openclaw/openclaw.json:

{
  "mcp": {
    "servers": {
      "gatana": { "url": "https://gatana.ai/mcp", "transport": "streamable-http" }
    }
  }
}

Most clients take this shape:

{
  "mcpServers": {
    "gatana": { "type": "http", "url": "https://gatana.ai/mcp" }
  }
}

A client that only asks for a URL takes https://gatana.ai/mcp. The client signs in over OAuth. A client that cannot do OAuth needs a personal access token.

Note: this does not install the skills, for that you need to use the Gatana CLI

Last updated on

On this page