Getting Started
Connect Your AI Assistant to CastHub
One URL. Three published connector guides. Any MCP-compatible client. Sign in with your CastHub credentials, Google, or Microsoft. Connected in under five minutes.
Before You Begin
Prerequisites
An active CastHub account
The connector cannot create accounts, so sign up first at dashboard.cast-hub.com/register-user. Any CastHub plan works, including Basic at $12 per month, because AI control is included in every plan with no add-on fee.
At least one screen registered and online
Add a screen in your CastHub dashboard before connecting your AI assistant. Once connected, the AI client will discover your screens automatically.
No API key required
Authentication uses OAuth 2.0 with PKCE and dynamic client registration. Sign in with your CastHub email and password, Google, or Microsoft. There is no key to copy, no header to configure, and no secret to rotate.
One URL
The CastHub MCP Connector URL
Every supported AI client uses the same connector URL. Paste it into your AI client's custom connector field. The client will redirect you to a CastHub sign-in page. Authorize the connection, and the connector is live.
https://webapi.cast-hub.com/mcp
Claude
Connect Claude Live
Claude supports CastHub through both Claude.ai (web) and Claude Desktop. Both use the same OAuth flow.
-
1
In Claude, open Settings, then Connectors.
-
2
Click Add custom connector.
-
3
Paste
https://webapi.cast-hub.com/mcpinto the URL field. -
4
Click Connect. Claude redirects you to a CastHub sign-in page.
-
5
Sign in with your CastHub credentials, Google, or Microsoft, then approve access.
Start a new conversation and ask Claude "What screens do I have connected?" to verify the connection.
ChatGPT
Connect ChatGPT Live
ChatGPT supports CastHub through its custom connectors feature on paid plans. The setup is identical to Claude with one prerequisite.
-
1
Verify your ChatGPT plan supports custom connectors. The feature is currently available on paid tiers.
-
2
In ChatGPT, open Settings, then Connectors, then Add a custom connector.
-
3
Paste
https://webapi.cast-hub.com/mcpinto the URL field. -
4
Click Connect. ChatGPT redirects you to a CastHub sign-in page.
-
5
Sign in and approve access.
-
6
Enable the CastHub connector in your chat to use its tools.
Full guide at cast-hub.com/ai-and-mcp/connect-chatgpt.
Microsoft Copilot
Connect Microsoft Copilot Live
Microsoft Copilot supports CastHub through its connector ecosystem using the same OAuth flow.
Full guide at cast-hub.com/ai-and-mcp/connect-microsoft-copilot.
Cursor and Beyond
Connect Any MCP-Compatible Client Live
The CastHub MCP server is built on the open Model Context Protocol standard, which means any compliant client can connect with the same URL and OAuth flow. This includes Cursor, custom MCP clients you build, and any future MCP-capable assistant.
If your client supports custom MCP servers with OAuth, point it at https://webapi.cast-hub.com/mcp. The server publishes RFC 9728 protected-resource metadata at /.well-known/oauth-protected-resource/mcp and RFC 7591 dynamic client registration is enabled.
Try It Out
Your First Conversation
Try these commands once connected. Read operations run immediately. Write operations will ask for your confirmation.
Read operations
Immediate, no confirmation
"What screens do I have connected?"
"Show me all my presentations."
"What is the schedule for the lobby screens?"
Write operations
Will request confirmation
"Push the welcome presentation to the lobby screens."
"Update the daily special on the restaurant menu boards."
"Create a presentation called Lobby Loop with our welcome web page and our promo image."
Device commands
Amazon Signage Stick required
"Check the health of all my devices."
"Restart the screen in Conference Room B."
"Capture a screenshot of what is displaying on the lobby screen."
"Turn the cafeteria displays off."
Help
Troubleshooting
The connector does not appear after setup
Fully restart the AI client (quit the application, do not just close the window). For ChatGPT, confirm your plan supports custom connectors. For Claude.ai, refresh the page after authorizing.
Authentication error
Confirm your CastHub account is active and not expired. If you sign in via Google or Microsoft, make sure your CastHub account was created with that identity provider. To re-run sign-in, remove the connector from the AI client and add it again.
Tool calls fail
Confirm at least one screen is connected and online in your CastHub dashboard. Try a read operation first, like listing screens, to isolate the issue.
Hardware tools not available
Hardware control tools (restart, display on or off, factory reset, screen capture) require an Amazon Signage Stick. Software-only screens running CastHub via browser or smart TV apps do not support hardware commands.