DocsOpen app
Docs/AI tools (MCP)/Claude Code

Connect Prowlo to Claude Code

Claude Code is Anthropic's CLI tool for agentic, autonomous coding. It supports MCP (Model Context Protocol) connections, allowing you to integrate Prowlo directly into your development workflow. Search your Dataset and query live Reddit data without leaving your terminal.

Two commands, no API key

Claude Code speaks HTTP MCP natively and handles the OAuth handshake itself — there is nothing to bridge, proxy, or install. Register the hosted URL, sign in, done.

Prerequisites

  • •Active Prowlo account with organization access
  • •Claude Code installed globally via npm: npm install -g @anthropic-ai/claude-code
  • •Node.js 18+ installed on your machine

No API key required for the OAuth path below. You only need one for headless environments — see API Keys.

Setup Guide

1

Register the Prowlo server

Run this once in your terminal. -s user installs Prowlo at the user scope so it is available in every project on your machine:

claude mcp add --transport http -s user prowlo https://api.prowlo.com/mcp

The --transport http flag matters. Without it Claude Code defaults to stdio and tries to run the URL as a local command, which fails.

2

Sign in with OAuth

This opens a browser window where you sign in to Prowlo. Claude Code stores the token and refreshes it for you:

claude mcp login prowlo
3

Verify the connection

Check that Claude Code sees the server:

claude mcp list

You should see prowlo marked as connected. Then start a session with claude and ask:

Search my Prowlo dataset for posts about pricing

Claude Code will call the Prowlo MCP tools and return matching records from your Dataset.

Choosing a scope

The -s flag decides who gets the server. Claude Code stores MCP servers in its own config — not in settings.json.

user

Available in every project on your machine. Best for Prowlo.

-s user

local

Only you, only in the current project. This is the default if you omit -s.

-s local

project

Written to .mcp.json in the repo and shared with your team via version control.

-s project

Sharing with a team

Use -s project to commit the server definition, and let each teammate run claude mcp login prowlo with their own Prowlo account. Never commit an API key to .mcp.json.

Connecting with an API key instead

OAuth needs a browser. In CI, a container, or a remote box without one, pass a key on theAuthorization header instead. Generate one at API Access — it is shown once.

claude mcp add --transport http -s user prowlo https://api.prowlo.com/mcp \
  --header "Authorization: Bearer prowlo_your_key_here"

Replace prowlo_your_key_here with your actual key. Skip claude mcp login — the header authenticates every request.

Usage Tips

Prowlo works especially well in Claude Code for:

→

Search your Dataset while coding

Ask Claude to search your Dataset for records on a topic, then have it summarize what users are saying.

→

Mine feedback with codebase context

Claude Code can read your codebase and your Prowlo Dataset in the same session—perfect for turning real user reports into issues or tasks.

→

Pull live Reddit context on demand

Ask Prowlo to read a live thread or search a subreddit when your Dataset hasn't captured it yet.

→

Manage Watchers without leaving the terminal

List, add, or update the Watchers that feed your Dataset conversationally. Ask Claude to review your source coverage or add new subreddits based on what you're seeing in the feed.

→

Tag records as you go

Claude Code can list, add, pause, or delete the keyword tags that label records in your Dataset.

Example Prompts

Here are some ways to use Prowlo in Claude Code:

"Search my dataset for posts in r/nodejs about API performance problems."

"Summarize the latest records that mention our open-source project."

"Pull the live Reddit thread for this record and show me the top comments."

"Find records where users describe the exact problem our product solves, ranked by relevance."

"List my Watchers and add one for r/CICD."

"Show me my tags and add one for 'deployment automation'."

Troubleshooting

Having issues? Here are common problems and solutions:

"spawn https://api.prowlo.com/mcp ENOENT" or the server fails instantly

  • • You added the server without --transport http, so Claude Code registered it as a local stdio command and tried to execute the URL
  • • Remove it with claude mcp remove prowlo and re-add it with the flag: claude mcp add --transport http -s user prowlo https://api.prowlo.com/mcp

MCP server not found

  • • Run claude mcp list to see what is registered
  • • If you added it with the default local scope, it only exists in the directory you ran the command in — re-add with -s user
  • • Exit the session and run claude again to reload

Authentication failed

  • • On the OAuth path, re-run claude mcp login prowlo; use claude mcp logout prowlo first to clear a stale token
  • • On the API-key path, verify the key hasn't been revoked in the Prowlo dashboard and that it starts with prowlo_
  • • Check that your trial or subscription is still active on Billing

Connection timeout

  • • Verify your internet connection is stable
  • • Check that you're using the correct MCP URL: https://api.prowlo.com/mcp
  • • Visit our troubleshooting guide for more help

Tools not appearing in Claude Code

  • • Run claude mcp get prowlo — it health-checks the server and shows the failure reason
  • • If the scope is project, approve the .mcp.json server when Claude Code prompts; unapproved servers show as ⏸ Pending approval
  • • Exit Claude Code and start a new session

Next Steps

Now that Prowlo is connected to Claude Code, you're ready to:

  • →Start a Claude Code session and search your Dataset for a topic
  • →Summarize what users are saying across your watched subreddits
  • →Turn real user reports into issues or tasks alongside your codebase
  • →Manage your Watchers and tags to keep your Dataset focused
← Claude DesktopVS Code →