> For the complete documentation index, see [llms.txt](https://www.cakewalk.security/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.cakewalk.security/docs/ai-agent-access/connections-and-integrations/agent-connections/planhat.md).

# Planhat

Connect your company's Planhat workspace to Cakewalk's MCP Gateway. Every agent tool call against Planhat passes through the gateway and is evaluated against your Policies.

Planhat lists its MCP server as Beta.

## Requirements

* Planhat user with access to App Center (required to create OAuth apps).

## About Scopes

Planhat has no fixed scope list. When you create the OAuth client, you set permission levels per Planhat data model (Companies, Contacts, and so on) for the operations the agent needs: create, update, view, or list. Grant only the models and operations your agents should access. The permission levels you set determine what the Connection can do once live.

## Step 1: Create an OAuth Client in Planhat

1. Sign in to your company's Planhat workspace.
2. Go to **App Center** > **New App** > **OAuth Client**.
3. Give the app a name, for example "Cakewalk Connector".
4. Under **Application Profile**, add a short description. It appears on the authorization screen.

## Step 2: Set Permission Levels

Set the permission levels for the Planhat data models you want agents to access. See [About Scopes](#about-scopes).

## Step 3: Configure the Redirect URL

In the **Redirect URLs** field, paste this URL:

```
https://mcp-gateway.getcakewalk.io/api/v1/Auth/Callback
```

## Step 4: Save and Copy Your Credentials

1. Click **Save**.
2. Planhat generates a Client ID (starts with `pk_`) and a Client Secret (starts with `sk_`).
3. Copy both. Planhat shows the Client Secret only once. If you lose it, you generate a new one and existing connections disconnect.

## Step 5: Paste Credentials Into Cakewalk

1. Open <https://app.getcakewalk.io>.
2. Go to All Connections.
3. Find Planhat.
4. Click Edit credentials.
5. Paste the Client ID and Client Secret.
6. Save.

## Verifying It Works

The Planhat Connection card flips to Active on All Connections. From an agent platform connected to Cakewalk, ask the agent to show your top companies in Planhat by ARR. If Planhat returns the data, the Connection is live.

## Troubleshooting

* Invalid redirect URI on consent: the value in **Redirect URLs** must match `https://mcp-gateway.getcakewalk.io/api/v1/Auth/Callback` exactly, with no trailing slash.
* 401 Unauthorized: the access token is missing or invalid. Recreate the Connection so the gateway runs OAuth again.
* 403 Forbidden: the OAuth client lacks permissions. Add the missing data model permission levels in Planhat App Center, then reconnect.
* Lost Client Secret: regenerate it on the OAuth client in App Center and repaste it in Cakewalk. Existing connections disconnect when you regenerate.

## Learn More

* [Planhat MCP Server](https://www.planhat.com/developers/ai/mcp-server/)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://www.cakewalk.security/docs/ai-agent-access/connections-and-integrations/agent-connections/planhat.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.