Setup Guide

Connect your AI assistant to AlwaysObvious in a few steps.

Before you start

1.An AlwaysObvious account. Sign up here if you don't have one yet.
2.An AI client that supports MCP — Claude Desktop, Claude Code, or Claude.ai.

Claude.ai (Web)

For individual Pro/Max users (personal settings)

Add the connector

Open claude.ai in your browser and sign in. Click your profile icon → Settings. Go to the Connectors section. This shows existing integrations and lets you add new ones. Click Add custom connector (or Add MCP Integration / similar wording, depending on UI version).

Fill in the connector details

Fill in the form: Name / Server name: any human‑readable label (e.g. “AlwaysObvious MCP”). Remote MCP server URL:

https://mcp.alwaysobvious.com/mcp

Add and authenticate

Click Add to create the connector. You'll be redirected to log in with your AlwaysObvious account (opens in new browser window). Grant access and the integration will appear in your chat.

Enable in chat

Open the Tools menu in a chat and enable the new connector so Claude can call that MCP server in conversations.

Claude Desktop

Open your config file

In Claude Desktop, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json.

Add the MCP server

Paste this into the file (or merge into an existing mcpServers object):

{
  "mcpServers": {
    "AlwaysObvious": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.alwaysobvious.com/mcp"
      ]
    }
  }
}

Restart and log in

Restart Claude Desktop. A browser window will open for you to log in with your AlwaysObvious account. After granting access you're ready to go.

Claude Code (CLI)

Add the server

Run this command in your terminal:

claude mcp add --transport http https://mcp.alwaysobvious.com/mcp

Authenticate

When you start a new conversation, Claude Code will open a browser window for you to log in. Grant access and you're connected.

Verify it works

Once connected, try this prompt in your AI client:

List my AlwaysObvious organisations

You should see the organisations you belong to. If you get an error, check that you're logged in and that the server URL is correct.

Need help? Contact support · Back to home