Connect an MCP server

Server	URL
`harwell`	`https://harwell.metaphi.ai/mcp/`
`kennet`	`https://kennet.metaphi.ai/mcp/`

The examples add harwell. For another server, change the name and the URL.

Claude Code
Codex
Cursor
VS Code
Hum

claude mcp add --transport http harwell https://harwell.metaphi.ai/mcp/

Then, in a session, run /mcp, pick harwell and choose Authenticate.

Add to ~/.codex/config.toml:

[mcp_servers.harwell]
url = "https://harwell.metaphi.ai/mcp/"

Then sign in:

codex mcp login harwell

Add to ~/.cursor/mcp.json, or .cursor/mcp.json in a project:

{
  "mcpServers": {
    "harwell": {
      "url": "https://harwell.metaphi.ai/mcp/"
    }
  }
}

Cursor asks you to sign in when the server first connects.

Add to .vscode/mcp.json:

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

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

hum mcp add harwell https://harwell.metaphi.ai/mcp/
hum mcp login harwell

The browser opens Metaphi AI’s sign-in. Once you are signed in, the client lists the tools your access reaches. If it lists none, request access.

From a service or CI

Send an organization key as a bearer token at the same URL.

Claude Code
Codex
Cursor
VS Code
Python

claude mcp add --transport http harwell https://harwell.metaphi.ai/mcp/ \
  --header "Authorization: Bearer $METAPHI_API_KEY"

[mcp_servers.harwell]
url = "https://harwell.metaphi.ai/mcp/"
bearer_token_env_var = "METAPHI_API_KEY"

{
  "mcpServers": {
    "harwell": {
      "url": "https://harwell.metaphi.ai/mcp/",
      "headers": {
        "Authorization": "Bearer mai_sk_..."
      }
    }
  }
}

{
  "inputs": [
    {"type": "promptString", "id": "metaphi-key", "description": "Metaphi API key", "password": true}
  ],
  "servers": {
    "harwell": {
      "type": "http",
      "url": "https://harwell.metaphi.ai/mcp/",
      "headers": {
        "Authorization": "Bearer ${input:metaphi-key}"
      }
    }
  }
}

import asyncio, os
from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client

async def main():
    headers = {"Authorization": f"Bearer {os.environ['METAPHI_API_KEY']}"}
    async with streamablehttp_client("https://harwell.metaphi.ai/mcp/", headers=headers) as (read, write, _):
        async with ClientSession(read, write) as session:
            await session.initialize()
            tools = await session.list_tools()
            print([t.name for t in tools.tools])

asyncio.run(main())

A failure to connect or sign in is on Errors.

Account

Reference

Connect an MCP server

From a service or CI

​Add the server and sign in

​From a service or CI

Add the server and sign in

From a service or CI