This guide walks you through connecting the ShingleAI MCP server to Claude Desktop, allowing Claude to access your contacts, messages, and other business data directly.Documentation Index
Fetch the complete documentation index at: https://docs.shingleai.com/llms.txt
Use this file to discover all available pages before exploring further.
Prerequisites
Before you begin, ensure you have:- Claude Desktop installed
- A ShingleAI account
Connect
Claude Desktop ships with native support for streamable-HTTP MCP servers and runs the OAuth 2.1 + PKCE handshake for you. The custom-connector UI used below requires a recent Claude Desktop build — if you don’t see Connectors under Settings, install the latest version from claude.ai/download.- Open Claude Desktop and go to Settings → Connectors → Add custom connector.
-
Paste the ShingleAI MCP URL as the server URL:
-
Click Connect. Claude Desktop opens a browser tab on
https://mcp.shingleai.com/oauth/authorize. -
Sign in to ShingleAI (if you aren’t already), then review the consent screen — choose which tool categories Claude Desktop may use, and decide whether to grant
offline_accessfor a long-lived refresh token. - Approve. The browser hands control back to Claude Desktop and the connector goes green.
Verification
Once the connection is working:- Open a new conversation in Claude Desktop
- Ask Claude: “What ShingleAI tools do you have access to?”
- Claude should list the available tools based on your permissions
Example Prompts
Once connected, you can ask Claude to interact with your ShingleAI data:| Task | Example Prompt |
|---|---|
| Find a contact | ”Find the contact information for John Smith” |
| Search messages | ”Show me recent messages about the project proposal” |
| View conversation | ”What’s the full email thread with support@example.com?” |
| Create a contact | ”Add a new contact for Jane Doe at jane@example.com” |
Troubleshooting
Claude doesn't see ShingleAI tools
Claude doesn't see ShingleAI tools
Possible causes:
- The connector wasn’t approved in the consent screen
- Tool categories were unchecked during consent
- The connector is showing red in Settings → Connectors
- Open Settings → Connectors and confirm the ShingleAI connector is green.
- If it’s red, click Reconnect and re-approve the consent screen.
- If it’s green but Claude can’t see specific tools, remove and re-add the connector — during consent, make sure the relevant tool categories are checked.
Authentication errors
Authentication errors
If the consent screen fails to load, check that you can reach
https://mcp.shingleai.com/.well-known/oauth-protected-resource from your machine and that you’re signed in to ShingleAI in the same browser Claude Desktop opened. If the connector goes red after a successful approval, remove and re-add it — Claude Desktop will register a fresh OAuth client via Dynamic Client Registration.Next Steps
Available Tools
Explore all available MCP tools
Authentication
Learn about MCP server authentication