MCP Setup

This guide walks you through adding OBI's MCP server to your AI assistant.

Claude Desktop

Claude Desktop is the recommended way to use OBI's MCP server.

Step 1: Locate Configuration File

Open your Claude Desktop configuration file:

# Open in your default editor
open ~/Library/Application\ Support/Claude/claude_desktop_config.json

# Or create if it doesn't exist
mkdir -p ~/Library/Application\ Support/Claude
touch ~/Library/Application\ Support/Claude/claude_desktop_config.json

# Located at
%APPDATA%\Claude\claude_desktop_config.json

Step 2: Add OBI Server

Add the OBI MCP server to your configuration:

{
  "mcpServers": {
    "obi": {
      "type": "http",
      "url": "https://mcp.heyobi.com"
    }
  }
}

Step 3: Restart Claude Desktop

Quit and reopen Claude Desktop to load the new configuration.

Step 4: Authenticate

When you first use an OBI tool, Claude will prompt you to authenticate:

1. Click the authentication link that appears
2. Sign in to your OBI account (or create one)
3. Authorize Claude to access your properties
4. Return to Claude Desktop

Once authenticated, your session persists until you sign out.

Claude Code (CLI)

For Claude Code, add OBI to your project or user settings:

{
  "mcpServers": {
    "obi": {
      "type": "http",
      "url": "https://mcp.heyobi.com"
    }
  }
}

{
  "mcpServers": {
    "obi": {
      "type": "http",
      "url": "https://mcp.heyobi.com"
    }
  }
}

Server Details

Manifest Endpoint

Clients can discover server capabilities via the manifest:

curl https://mcp.heyobi.com/manifest

{
  "name": "OBI",
  "description": "AI-powered property intelligence",
  "version": "1.0.0",
  "protocol_version": "2024-11-05",
  "authentication": {
    "type": "oauth2",
    "authorization_url": "https://app.heyobi.com/oauth/authorize",
    "token_url": "https://oktnratupvznraxkclus.supabase.co/auth/v1/token",
    "scopes": ["openid", "email", "profile"]
  },
  "tools": ["list_properties", "search_items", "add_item", "ask_obi", "identify_item"]
}

Verifying Connection

After setup, ask Claude to list your properties:

"What properties do I have in OBI?"

If configured correctly, Claude will use the list_properties tool and show your properties.

Troubleshooting

"Server not found" error

• Verify the URL is exactly https://mcp.heyobi.com
• Check your internet connection
• Ensure Claude Desktop is updated to the latest version

Authentication fails

• Clear your browser cache and try again
• Ensure you have an active OBI account at app.heyobi.com
• Check that third-party cookies are enabled

Tools not appearing

• Restart Claude Desktop after editing the config
• Validate your JSON syntax (use a JSON linter)
• Check Claude Desktop logs for errors

Next Steps

• Authentication Details - Learn about the OAuth flow
• Available Tools - Explore what you can do