Wallboard API - MCP Integration (1.0)

With MCP connected, you can talk to your AI assistant in natural language:

• "Show me all devices that are offline"
• "List content in the Lobby folder"
• "Create a new device group called Reception Screens"
• "Change the brightness to 80% on device XYZ"
• "What channels are scheduled for tomorrow?"
• "How does content scheduling work?"

The AI finds the right API endpoints and executes them for you - no coding required.

---

Wallboard supports Dynamic Client Registration (DCR) — clients that support it only need the server URL. No Client ID or Client Secret required.

Client	DCR	Setup
Claude Code, Cursor, ChatGPT	Yes	URL only — authentication is fully automatic
Claude.ai	No	Create OAuth Client first (Client ID + Secret required)
Other MCP clients	Varies	URL only if DCR supported, otherwise manual OAuth config

---

Step 1: Create OAuth Client in Wallboard

1. Log in to Wallboard
2. Go to Customer Settings → Integrations → OAuth Clients (or System Settings → OAuth Clients for system-wide)
3. Click Create OAuth Client
4. Fill in:

Field	Value
Name	Claude AI Assistant (or any name you'll recognize)
Redirect URI	https://claude.ai/api/mcp/auth_callback
Public	OFF (must be off to get a Client Secret)

5. Save and copy the Client ID and Client Secret

Step 2: Add MCP Server in Claude.ai

1. Go to claude.ai → Settings → Connectors
2. Click Add Integration or Add Remote MCP Server
3. Enter:

Field	Value
Server URL	https://YOUR_WALLBOARD_SERVER/mcp
Client ID	(paste from Step 1)
Client Secret	(paste from Step 1)

Replace YOUR_WALLBOARD_SERVER with your Wallboard server URL (the same URL you use to log in).

Note: If Claude asks for Authorization URL or Token URL, use https://YOUR_WALLBOARD_SERVER/authorize and https://YOUR_WALLBOARD_SERVER/token

Step 3: Connect

1. Click Connect
2. Log in to Wallboard when prompted
3. Done! Start chatting with Claude about your Wallboard data

---

Add to your project's .mcp.json (or ~/.claude/.mcp.json for global):

{
  "mcpServers": {
    "wallboard": {
      "type": "http",
      "url": "https://YOUR_WALLBOARD_SERVER/mcp"
    }
  }
}

Replace YOUR_WALLBOARD_SERVER with your Wallboard server URL.

On first use, Claude Code opens your browser for login automatically — no manual OAuth setup needed.

---

ChatGPT supports Dynamic Client Registration, so setup is URL only — no Client ID or Client Secret required.

Requirements

Requirement	Detail
Plan	ChatGPT Pro, Plus, Business, Enterprise, or Edu (custom connectors are not available on Free)
Developer mode	Enable Developer mode in ChatGPT settings — look under Connectors → Advanced settings (some versions place it under Apps or Security & login). On Business/Enterprise/Edu, a workspace admin must allow custom connectors first.

Step 1: Add the Connector

1. In ChatGPT, open Settings → Connectors (labeled Apps in some versions) and click Create / + to add a custom connector
2. Enter:

Field	Value
Name	Wallboard
MCP Server URL	https://YOUR_WALLBOARD_SERVER/mcp
Authentication	OAuth

Replace YOUR_WALLBOARD_SERVER with your Wallboard server URL (the same URL you use to log in).

Step 2: Authenticate

1. Click Create / Connect
2. ChatGPT registers itself with Wallboard automatically and opens a login window
3. Log in to Wallboard and approve access

Step 3: Use It

Enable the Wallboard connector in a chat, then start asking about your Wallboard data.

---

Any MCP client that supports the MCP Authorization spec works automatically:

Setting	Value
MCP Server URL	https://YOUR_WALLBOARD_SERVER/mcp
Transport	Streamable HTTP

The client discovers OAuth settings automatically via the server's metadata endpoints. Clients that support Dynamic Client Registration (RFC 7591) require no manual OAuth setup.

For clients that need manual OAuth configuration:

Setting	Value
Authorization URL	https://YOUR_WALLBOARD_SERVER/authorize
Token URL	https://YOUR_WALLBOARD_SERVER/token
Scope	FULL_ACCESS

---

"Not authorized" or login keeps appearing

• Your session expired - log in again

Can't connect to MCP server

• Check the URL is correct (should end with /mcp)
• Verify the server is reachable

OAuth client not working (Claude.ai)

• Verify the redirect URI is exactly: https://claude.ai/api/mcp/auth_callback
• Check Client ID and Secret are copied correctly (no extra spaces)
• Make sure Public is OFF when creating the OAuth client

"Create connector" option missing (ChatGPT)

• Confirm your plan supports custom connectors (Pro, Plus, Business, Enterprise, or Edu)
• Enable Developer mode in ChatGPT settings (under Connectors → Advanced settings, or Apps / Security & login depending on version)
• On Business/Enterprise/Edu, ask a workspace admin to allow custom connectors