Claude

Connect Claude to query your Semaphor analytics data through natural conversation.

Prerequisites

• A Claude plan that supports MCP integrations
• A Semaphor account (organization user)
• At least one project with data connections configured

Setup

1. Open Claude Settings and navigate to Connectors
2. Click Add Custom Connector
3. Enter a name (e.g., Semaphor)
4. Enter the remote MCP server URL:

   https://semaphor.cloud/api/mcp

5. Expand Advanced Settings
6. Enter the OAuth Client ID:

   6e255134da304553998418c53bd59d85

7. Click Add
8. When redirected, sign in with your Semaphor credentials and authorize the connection

First Steps

After connecting, start a new conversation and try:

1. List your projects: "List my Semaphor projects"
2. Pick a project: "Use Marketing Analytics for my questions"
3. Explore data: "What datasets are available in that project?"
4. Ask a question: "Show me monthly revenue trends"

Example Conversation

You: "What Semaphor projects can I access?"

Claude calls: semaphor_list_projects
Claude: "You have access to 3 projects:
  1. Sales Dashboard (p_abc123)
  2. Marketing Analytics (p_def456)
  3. Engineering Metrics (p_ghi789)"

You: "Select Marketing Analytics and show me campaign performance"

Claude calls: semaphor_get_analysis_context with projectId "p_def456"
Claude calls: semaphor_list_datasets with projectId "p_def456"
Claude calls: semaphor_get_dataset_schema with projectId "p_def456"
Claude calls: semaphor_query_sql with projectId "p_def456"
Claude: "Here's your campaign performance for the current quarter..."

Troubleshooting

• Integration not appearing — Verify your Claude plan supports MCP integrations
• "Authentication required" — Try removing and re-adding the integration
• "No active project" — Ask Claude to list your projects, then specify which project to use

See Troubleshooting for more common issues.