Install · test · troubleshoot

Get ANHA working in your AI tool

Twelve guides. Each one covers what to install, how to check it worked, and what to do when it did not.

First, get your free @handle

Your AI helper needs your own @handle before it can use ANHA. This part takes about five minutes, and a grown-up should do it with you.

Start here

ANHA can place real orders with real shops. Always ask a grown-up before you buy anything.

Step two

Pick your AI tool

Click to connect

No install — written for beginners

01ClaudeNo install 02GeminiNo install 03GrokNo install

Terminal

Config file or command line

01CodexTerminal 02CopilotConfig file 03QwenConfig file 04OpenClawTerminal 05HermesConfig file

Through another agent

No connector of their own

01GLMVia an agent 02DeepSeekVia an agent

Build and operate

For developers and operators

01Your own agentBuild 02Run a nodeOperator

Downloads

Everything you might need to install

anha-mcpnpm Node.jsLTSANHA mobileComing soon

Beginner tutorial

How to install and use ANHA

ANHA is like a phone book for AI helpers. Shops, people, and robot helpers each get a name that starts with @, like @nike.ai. Your AI helper looks up the name in ANHA. ANHA checks that the name is real and tells your helper how to reach it.

What you need

A computer with internet.
An email address you can open.
Your own @handle. It is free, and the first part below shows how.
An AI helper, like Claude, ChatGPT, Gemini, Grok, or Qwen.
A grown-up nearby, if you are a kid.

Safety first: ANHA can place real orders with real shops. Always ask a grown-up before you buy anything.

First: get your free @handle

Do this first⏱ About 5 minutes

Your AI helper needs your own @handle before it can use ANHA. A grown-up should do this part with you.

Open the sign-up page
Open the personal sign-up page on this website.
Type your name in the box called Your name.
Click Continue.
Open the personal sign-up page →
ANHA adds a short code to the end of your name. That makes your @handle only yours.
Check your email
Type your email address. Click Send code.
Open your email and find the 6-digit code.
Type the code on the page. Click Verify.
Remember this email. You will sign in with it again later.
Tell us who you are
Type your full name and your country.
Click Run checks & continue.
Every sign-up gets a quick safety check. This is normal.
Skip the settings
The next page is called Configure.
You do not need to change anything.
Click Continue.
Make your key file
Click Generate keypair in browser.
A key file downloads to your computer.
Keep that file safe and never share it.
The key file proves the @handle is yours. We cannot send you a new one.
Finish
Your first personal @handle is free.
Click Complete registration.
Now your @handle is ready!

Then pick the way that fits your AI helper. Way 1 is the easiest.

Way 1: Add ANHA to Claude or ChatGPT Way 2: Install ANHA with npm Way 3: Gemini, Grok, Qwen, DeepSeek, or GLM Way 4: AI agents like OpenClaw or Hermes Way 5: Build your own agent 📦 anha-mcp on npm ↗

Way 1: Add ANHA to Claude or ChatGPT

Easiest⏱ About 2 minutes

Pick this way if you use Claude or ChatGPT. You do not install anything.

Open your AI helper
Open Claude or ChatGPT.
The app and the website both work.
Go to Connectors
Click Settings.
Then click Connectors.
Can't find Settings? Look for a small gear icon or your name in a corner.
3
Add ANHA
Click Add custom connector.
For the name, type ANHA.
For the web address, copy and paste the link below.
Web address
```
https://resolver.anha.ai/mcp
```
Sign in and say yes
A new ANHA page opens.
Sign in with the same email you used for your @handle.
Type the code we email you.
Pick your @handle from the list.
Read what your AI helper may do. Then click Allow.
You never have to copy a password or a secret key.
5
Try it!
Go back to your chat.
Type the message below and press Enter.
Type this
```
Use ANHA to find a shop that sells groceries.
```
Your AI helper will use ANHA to look for shops and show you what it found.

Way 2: Install ANHA with npm

Uses npm⏱ About 10 minutes

Pick this way if your AI app runs on your computer, like Claude Desktop, Cursor, or a coding helper.

Get Node.js
Node.js is a free program.
It lets your computer run the ANHA helper.
Go to the Node.js website.
Download the version that says LTS.
Install it like any other app.
Open nodejs.org ↗
Ask a grown-up before you install a program.
Open the Terminal
The Terminal is a window where you type orders to your computer.
On Windows, press the Windows key. Type PowerShell. Press Enter.
On a Mac, press Command and Space. Type Terminal. Press Enter.
3
Check that Node.js works
Type the line below and press Enter.
You should see a number that starts with v.
Type this
```
node -v
```
Do you see an error? Close the Terminal. Open it again and try once more.
4
Install ANHA and sign in
Type the line below and press Enter.
It gets the ANHA helper from npm.
Then your web browser opens.
Sign in with the same email you used for your @handle.
Pick your @handle. Then click Allow.
Type this
```
npx -y anha-mcp login
```
See anha-mcp on npm ↗
When the Terminal says it is authorized, you are done with this step.
5
Tell your AI app about ANHA
In Claude Desktop, click Settings. Then click Developer. Then click Edit Config.
A file opens.
Paste the text below into the file and save it.
Close Claude all the way. Then open it again.
Paste this
```
{
  "mcpServers": {
    "anha": {
      "command": "npx",
      "args": [
        "-y",
        "anha-mcp"
      ]
    }
  }
}
```
Is the file already full of text? Ask a grown-up to help add the anha part.
6
Try it!
Go back to your chat.
Type the message below and press Enter.
Type this
```
Use ANHA to find a shop that sells groceries.
```
Your AI helper will use ANHA to look for shops and show you what it found.

Way 3: Gemini, Grok, Qwen, DeepSeek, or GLM

Pick your app⏱ About 5 minutes

Click the name of your AI helper to see its own steps.

Gemini (website)For the Gemini website. A grown-up must set this one up.

Check the rules
Only grown-ups can add apps to Gemini.
You must be 18 or older and live in the US.
Use a personal Google account, not a school or work one.
Open Connected Apps
Go to the Gemini website on a computer.
Click Settings & help. Then click Connected Apps.
Open gemini.google.com ↗
Don't see Connected Apps? Click Personal Intelligence first.
3
Add ANHA
Click Add a custom app.
Paste the ANHA web address. Then click Next.
Web address
```
https://resolver.anha.ai/mcp
```
Sign in and say yes
A new ANHA page opens.
Sign in with the same email you used for your @handle.
Pick your @handle. Then click Allow.
5
Try it!
Go back to your Gemini chat.
Type @ and pick ANHA. Then type the message below.
Type this
```
Use ANHA to find a shop that sells groceries.
```
Your AI helper will use ANHA to look for shops and show you what it found.

Gemini CLIFor Gemini in the Terminal.

1
Add ANHA
Open the Terminal.
Type the line below and press Enter.
Type this
```
gemini mcp add --transport http anha https://resolver.anha.ai/mcp
```
2
Start the sign-in
Type gemini and press Enter to start Gemini.
Then type the line below and press Enter.
Type this
```
/mcp auth anha
```
Sign in and say yes
Your web browser opens an ANHA page.
Sign in with the same email you used for your @handle.
Pick your @handle. Then click Allow.
4
Check that it worked
Close Gemini. Type the line below and press Enter.
The anha line should say Connected.
Type this
```
gemini mcp list
```
5
Try it!
Start Gemini again.
Type the message below and press Enter.
Type this
```
Use ANHA to find a shop that sells groceries.
```
Your AI helper will use ANHA to look for shops and show you what it found.

GrokFor the Grok website and app.

Open Connectors
Sign in to Grok on the web.
Go to the Connectors page.
Open grok.com/connectors ↗
2
Add ANHA
Click New Connector. Then click Custom.
Paste the ANHA web address.
Web address
```
https://resolver.anha.ai/mcp
```
Using Grok at work? A team admin may need to add it for you first.
Sign in and say yes
Grok asks you to sign in, and an ANHA page opens.
Sign in with the same email you used for your @handle.
Pick your @handle. Then click Allow.
4
Try it!
Go back to your Grok chat.
Type the message below and press Enter.
Type this
```
Use ANHA to find a shop that sells groceries.
```
Your AI helper will use ANHA to look for shops and show you what it found.

Qwen Chat (desktop app)For the Qwen Chat app on your computer.

Install the ANHA helper first
Do steps 1 to 4 of Way 2 on the computer that runs your AI helper.
That installs the ANHA helper and signs you in.
Go to Way 2
Open MCP settings
Open the Qwen Chat desktop app.
Click MCP. Then click MCP settings.
Click Add MCP.
Only the desktop app can add tools. The website cannot.

Add ANHA

Choose the option to paste settings.

Paste the text below. Then save it and turn it on.

Paste this

{
  "mcpServers": {
    "anha": {
      "command": "npx",
      "args": [
        "-y",
        "anha-mcp"
      ]
    }
  }
}

4
Try it!
Start a new Qwen chat.
Type the message below and press Enter.
Type this
```
Use ANHA to find a shop that sells groceries.
```
Your AI helper will use ANHA to look for shops and show you what it found.

Qwen CodeFor Qwen in the Terminal.

Install the ANHA helper first
Do steps 1 to 4 of Way 2 on the computer that runs your AI helper.
That installs the ANHA helper and signs you in.
Go to Way 2
2
Open the Qwen Code settings file
Open the file at the place shown below.
A grown-up can help you find it.
File
```
~/.qwen/settings.json
```
3
Add ANHA
Paste the text below into the file and save it.
Paste this
```
{
  "mcpServers": {
    "anha": {
      "command": "npx",
      "args": [
        "-y",
        "anha-mcp"
      ]
    }
  }
}
```
Is the file already full of text? Ask a grown-up to add the mcpServers part inside it.
4
Check that it worked
Start Qwen Code. Type the line below and press Enter.
ANHA should show as ready.
Type this
```
/mcp
```
5
Try it!
Now ask Qwen Code.
Type the message below and press Enter.
Type this
```
Use ANHA to find a shop that sells groceries.
```
Your AI helper will use ANHA to look for shops and show you what it found.

DeepSeekDeepSeek uses ANHA through an agent app or your own program.

Pick an agent app
DeepSeek is the brain. It needs an agent app to use ANHA.
Pick an agent that lets you choose DeepSeek, like OpenClaw or Hermes.
Go to Way 4
Choose DeepSeek
In the agent's settings, choose DeepSeek as the model.
You will need a key from the DeepSeek website.
That key is only for DeepSeek. ANHA never needs a key.
Add ANHA to the agent
Follow the steps for your agent in Way 4.
Writing your own program?
Follow Way 5 instead. It works with DeepSeek.
Go to Way 5

GLM (Z.ai)GLM uses ANHA through an agent app or your own program.

Pick an agent app
GLM is the brain. It needs an agent app to use ANHA.
Pick an agent that lets you choose GLM, like OpenClaw or Hermes.
Go to Way 4
Choose GLM
In the agent's settings, choose GLM as the model.
You will need a key from the Z.ai website.
That key is only for GLM. ANHA never needs a key.
Add ANHA to the agent
Follow the steps for your agent in Way 4.
Writing your own program?
Follow Way 5 instead. It works with GLM.
Go to Way 5
Z.ai can only reach tool servers with a fixed key. ANHA has no key, so use Way 5.

Way 4: AI agents like OpenClaw or Hermes

Agents⏱ About 10 minutes

An agent is an AI helper that does jobs on its own. Click your agent to see its steps.

OpenClawFor the OpenClaw agent.

Install the ANHA helper first
Do steps 1 to 4 of Way 2 on the computer that runs your AI helper.
That installs the ANHA helper and signs you in.
Go to Way 2
2
Add ANHA
Open the OpenClaw Control UI.
Click Settings. Then click MCP. Then click Add server.
Name it anha. Use the details below.
Server details
```
{
  mcp: {
    servers: {
      anha: {
        command: "npx",
        args: ["-y", "anha-mcp"],
        transport: "stdio",
        enabled: true,
      },
    },
  },
}
```
You can also add these details to the OpenClaw settings file.
3
Load ANHA
Open the Terminal.
Type the line below and press Enter.
Type this
```
openclaw mcp reload
```
4
Check that it worked
Type the line below and press Enter.
It should list the ANHA tools.
Type this
```
openclaw mcp doctor anha --probe
```
5
Try it!
Ask your OpenClaw agent.
Type the message below and press Enter.
Type this
```
Use ANHA to find a shop that sells groceries.
```
Your AI helper will use ANHA to look for shops and show you what it found.

Hermes AgentFor the Hermes agent by Nous Research.

Install the ANHA helper first
Do steps 1 to 4 of Way 2 on the computer that runs your AI helper.
That installs the ANHA helper and signs you in.
Go to Way 2
2
Add ANHA
Open the Hermes settings file. It is shown below.
Paste the text at the end of the file and save it.
Paste this into ~/.hermes/config.yaml
```
mcp_servers:
  anha:
    command: "npx"
    args: ["-y", "anha-mcp"]
```
Does the file already have mcp_servers in it? Add only the anha part under it.
3
Load ANHA
In your Hermes chat, type the line below and press Enter.
Type this
```
/reload-mcp
```
On Windows, Hermes runs inside WSL. Do every step there, including Way 2.
Check that it worked
Ask Hermes which MCP tools it has right now.
You should see tools with anha in their names.
5
Try it!
Ask Hermes.
Type the message below and press Enter.
Type this
```
Use ANHA to find a shop that sells groceries.
```
Your AI helper will use ANHA to look for shops and show you what it found.

Any other AI agentFor agents that are not listed here.

Find the tools settings
Open your agent's settings.
Look for a page called MCP, Tools, or Connectors.
2
If it asks for a web address
Paste the ANHA web address.
Sign in with the same email you used for your @handle.
Pick your @handle. Then click Allow.
Web address
```
https://resolver.anha.ai/mcp
```
3
If it asks for a command
Do steps 1 to 4 of Way 2 first.
Then use the command and settings below.
Command and settings
```
{
  "mcpServers": {
    "anha": {
      "command": "npx",
      "args": [
        "-y",
        "anha-mcp"
      ]
    }
  }
}
```
Go to Way 2
Leave keys empty
ANHA does not use a key or a password.
If the agent asks for a key or a header, leave it empty.
A key there can stop the ANHA sign-in page from ever opening.
5
Try it!
Ask your agent.
Type the message below and press Enter.
Type this
```
Use ANHA to find a shop that sells groceries.
```
Your AI helper will use ANHA to look for shops and show you what it found.

Way 5: Build your own agent

For builders⏱ About 20 minutes

Pick this way if you write your own AI program. Click the choice that fits your program.

My program speaks MCPThe best choice. Your program signs in by itself.

1
Connect to ANHA
Point your MCP client at the web address below.
Do not add a key or a header.
Web address
```
https://resolver.anha.ai/mcp
```
Turn on sign-in
Use an MCP client library that can sign in on its own.
The first time, it opens a web page.
Sign in with the same email you used for your @handle.
Pick your @handle. Then click Allow.
Use the tools
Ask ANHA for its list of tools.
Your program only sees the tools you allowed.

My program starts a helper programYour program runs the ANHA helper, and the helper signs in.

Install the ANHA helper first
Do steps 1 to 4 of Way 2 on the computer that runs your AI helper.
That installs the ANHA helper and signs you in.
Go to Way 2
2
Start the helper
Have your program start the command below.
Talk to it through its input and output.
Command
```
npx -y anha-mcp
```
The helper writes its notes to the error output. Its normal output is only for your program.

My program uses a model's tool callingWorks with DeepSeek, GLM, Qwen, Grok, and many other models.

1
Get the ANHA tool list
Download the tool list from the address below.
Give it to your model as its tools.
Tool list
```
https://resolver.anha.ai/tools.json
```

Match each tool to a web address

When the model picks a tool, call the matching ANHA address.

Skip the delegate task tool. Only ANHA nodes can run it.

Tool and web address

resolve_anha_handle     GET  https://resolver.anha.ai/v1/resolve?id={handle}
search_anha_agents      GET  https://resolver.anha.ai/v1/search?capability=&industry=&limit=
get_anha_brand_pack     GET  https://resolver.anha.ai/v1/brand/{handle}
get_anha_reputation     GET  https://resolver.anha.ai/v1/reputation/{handle}
get_anha_authenticity   GET  https://resolver.anha.ai/v1/authenticity/{handle}
list_anha_industries    GET  https://resolver.anha.ai/v1/industries
invoke_anha_capability  POST https://resolver.anha.ai/v1/invoke  {handle, capability, args}
poll_anha_invocation    GET  https://resolver.anha.ai/v1/invoke/{request_id}

Put it all together

This short Python program does every step.

Set your model's address, key, and name first.

Python

import json, os, urllib.parse
import requests
from openai import OpenAI  # any OpenAI-compatible model API

ANHA = "https://resolver.anha.ai"
q = lambda s: urllib.parse.quote(s, safe="")

def call_anha(name, a):
    if name == "resolve_anha_handle":
        return requests.get(f"{ANHA}/v1/resolve", params={"id": a["handle"]})
    if name == "search_anha_agents":
        return requests.get(f"{ANHA}/v1/search", params=a)
    if name == "get_anha_brand_pack":
        return requests.get(f"{ANHA}/v1/brand/{q(a['handle'])}")
    if name == "get_anha_reputation":
        return requests.get(f"{ANHA}/v1/reputation/{q(a['handle'])}")
    if name == "get_anha_authenticity":
        return requests.get(f"{ANHA}/v1/authenticity/{q(a['handle'])}")
    if name == "list_anha_industries":
        return requests.get(f"{ANHA}/v1/industries")
    if name == "invoke_anha_capability":
        return requests.post(f"{ANHA}/v1/invoke", json=a)
    if name == "poll_anha_invocation":
        return requests.get(f"{ANHA}/v1/invoke/{q(a['request_id'])}")
    raise ValueError(f"unknown tool {name}")

# delegate_task_to_handle is served by ANHA nodes, not this API.
tools = [t for t in requests.get(f"{ANHA}/tools.json").json()
         if t["function"]["name"] != "delegate_task_to_handle"]

client = OpenAI(base_url=os.environ["MODEL_BASE_URL"], api_key=os.environ["MODEL_API_KEY"])
messages = [{"role": "user", "content": "Use ANHA to find a shop that sells groceries."}]

while True:
    msg = client.chat.completions.create(
        model=os.environ["MODEL_NAME"], messages=messages, tools=tools
    ).choices[0].message
    messages.append(msg)
    if not msg.tool_calls:
        print(msg.content)
        break
    for call in msg.tool_calls:
        r = call_anha(call.function.name, json.loads(call.function.arguments or "{}"))
        messages.append({"role": "tool", "tool_call_id": call.id, "content": r.text})

Get the address, key, and model name from your model company. The ANHA addresses need no key.

Wait for approvals
Some shops ask their owner's phone to approve an order.
Then ANHA answers pending, with a request number.
Ask again later with the poll tool.

Words to know

@handle: A name that starts with @. It is like a username for a shop, a person, or a robot helper.
AI helper: An app you can chat with, like Claude or ChatGPT.
Agent: An AI helper that can do jobs on its own, step by step.
Connector: A plug that lets your AI helper use another service.
npm: A free online library of programs. The ANHA helper lives there.
Node.js: A free program your computer needs to run things from npm.
Terminal: A window where you type orders to your computer.
One-time code: A short number we email you. You type it in to sign in, so you need no password.
Key file: A file that proves your @handle is yours. Keep it safe, like a house key.
MCP: The language AI helpers use to talk to tools like ANHA.

Stuck? Try this

After I sign in, the page says No handles yet.
That email does not own an @handle. Sign in with the email you used to sign up. Or get your free @handle first.
My app or agent asks for a key, a token, or a header.
Leave it empty. ANHA has no key. A key there can stop the sign-in page from opening.
The Terminal says npx is not recognized, or command not found.
Node.js is not installed yet. Install it. Then close the Terminal and open it again.
My AI helper does not see ANHA.
Close the app all the way, then open it again. Closing the window is not always enough.
I want to turn ANHA off.
Sign in to ANHA and open the Connected apps page at the web address below. Remove your AI helper there.
Web address
```
https://anha.ai/dashboard/connected
```
I used the ANHA helper and want to sign it out on my computer.
Type this line in the Terminal and press Enter.
Type this
```
npx -y anha-mcp logout
```

Using Cursor, VS Code or another tool? See every way to connect.

First, get your free @handle

Click to connect

Terminal

Through another agent

Build and operate

What you need

Open the sign-up page

Check your email

Tell us who you are

Skip the settings

Make your key file

Finish

Open your AI helper

Go to Connectors

Add ANHA

Sign in and say yes

Try it!

Get Node.js

Open the Terminal

Check that Node.js works

Install ANHA and sign in

Tell your AI app about ANHA

Try it!

Check the rules

Open Connected Apps

Add ANHA

Sign in and say yes

Try it!

Add ANHA

Start the sign-in

Sign in and say yes

Check that it worked

Try it!

Open Connectors

Add ANHA

Sign in and say yes

Try it!

Install the ANHA helper first

Open MCP settings

Add ANHA

Try it!

Install the ANHA helper first

Open the Qwen Code settings file

Add ANHA

Check that it worked

Try it!

Pick an agent app

Choose DeepSeek

Add ANHA to the agent

Writing your own program?

Pick an agent app

Choose GLM

Add ANHA to the agent

Writing your own program?

Install the ANHA helper first

Add ANHA

Load ANHA

Check that it worked

Try it!

Install the ANHA helper first

Add ANHA

Load ANHA

Check that it worked

Try it!

Find the tools settings

If it asks for a web address

If it asks for a command

Leave keys empty

Try it!

Connect to ANHA

Turn on sign-in

Use the tools

Install the ANHA helper first

Start the helper

Get the ANHA tool list

Match each tool to a web address

Put it all together

Wait for approvals

Words to know

Stuck? Try this