Claude Integration Guide

Overview

Claude (by Anthropic) natively supports the Model Context Protocol. Connect Claude to any ezForge Ready MCP server to let it query business hours, browse offerings, check availability, and more — using its built-in MCP client.

Prerequisites

An ezForge Ready business with a deployed MCP server
Your MCP server URL (format: https://<slug>.mcp.ezforge.ai)
Claude Desktop ≥ 0.10 or access to the Claude API with MCP tool-use support

Connecting via Claude Desktop

Add the server to your Claude Desktop configuration file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "my-business": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-http"],
      "env": {
        "MCP_SERVER_URL": "https://<slug>.mcp.ezforge.ai/sse"
      }
    }
  }
}

Replace <slug> with your business slug (visible in the Ready dashboard under Server → Settings). Claude Desktop will prompt you to authenticate via OAuth 2.1 on first connection.

Connecting via the Claude API

Use the MCP connector in the Claude API to pass tool results from an ezForge Ready server:

import anthropic

client = anthropic.Anthropic()

response = client.beta.messages.create(
    model="claude-opus-4-6",
    max_tokens=1024,
    tools=[
        {
            "type": "mcp",
            "server_url": "https://<slug>.mcp.ezforge.ai",
            "server_name": "my-business",
        }
    ],
    messages=[{"role": "user", "content": "What are the business hours?"}],
    betas=["mcp-client-2025-04-04"],  # Update this string when the MCP client beta graduates or the date changes
)
print(response.content)

Maintenance: The betas=["mcp-client-2025-04-04"] header enables the MCP client beta in the Anthropic API. If the beta graduates to general availability or the beta string date changes, this value must be updated (or removed). Check the Anthropic changelog for the latest status.

OAuth 2.1 Authentication

ezForge Ready servers use OAuth 2.1 with PKCE (RFC 7636). Claude handles the full OAuth flow automatically — no manual token management required. Discovery endpoints:

Endpoint	Purpose
`/.well-known/oauth-protected-resource`	RFC 9728 — advertises the authorization server
`/.well-known/oauth-authorization-server`	RFC 8414 — authorization server metadata
`/.well-known/mcp-server-metadata`	ezForge discovery — business info, vertical, agent hints

Available Tools

All Ready MCP servers expose a common base tool set plus vertical-specific tools:

Base tools (all verticals)

Tool	Description
`get_business_info`	Business name, description, and category
`get_hours`	Current and weekly operating hours
`get_contact_info`	Phone, email, address, and website

Restaurant tools

Tool	Description
`search_menu`	Search menu items by keyword or category
`get_menu_item`	Full details for a single menu item
`check_dietary`	Filter items by dietary restriction
`request_reservation`	Request a table reservation
`check_availability`	Check reservation availability for a date/party size
`place_order`	Place an online order

Salon & Spa tools

Tool	Description
`search_services`	Search services by keyword or category
`get_service_details`	Full details for a single service
`check_availability`	Check appointment availability
`book_appointment`	Book an appointment
`get_cancellation_policy`	Retrieve the cancellation policy

Home Services tools

Tool	Description
`get_services`	List all offered services
`check_service_area`	Check if a zip code is in the service area
`request_quote`	Request a quote for a job
`check_availability`	Check appointment availability
`verify_credentials`	Retrieve licenses and insurance on file

Discovering Businesses

Use the ezForge directory API to find Ready-powered businesses:

curl "https://ezforge.ai/api/v1/directory?vertical=restaurant&city=Detroit"

Each listing includes the mcpServerUrl you can pass directly to Claude.

Troubleshooting

Authentication loop — ensure your Claude Desktop is up to date; OAuth PKCE support requires ≥ 0.10. Tool not found — confirm the business has the relevant vertical template deployed. The get_business_info tool is available on every server; vertical tools depend on the template type. Rate limiting — the /.well-known/mcp-server-metadata endpoint is rate-limited per IP. If you are building a crawler or aggregator, cache the metadata response for at least 5 minutes.

​Overview

​Prerequisites

​Connecting via Claude Desktop

​Connecting via the Claude API

​OAuth 2.1 Authentication

​Available Tools

​Base tools (all verticals)

​Restaurant tools

​Salon & Spa tools

​Home Services tools

​Discovering Businesses

​Troubleshooting

Overview

Prerequisites

Connecting via Claude Desktop

Connecting via the Claude API

OAuth 2.1 Authentication

Available Tools

Base tools (all verticals)

Restaurant tools

Salon & Spa tools

Home Services tools

Discovering Businesses

Troubleshooting