# Asana

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

## Requirements

* An Asana workspace member who can create apps at [app.asana.com/0/my-apps](https://app.asana.com/0/my-apps).
* Access to the workspace you plan to connect, so you can add it to the app's distribution list.

## Required Scopes

The Asana MCP server does not require custom OAuth scopes. Asana issues an access token with the default scope, which covers every available MCP tool.

## Step 1: Create an Asana MCP App

1. Open <https://app.asana.com/0/my-apps> and sign in.
2. Click **Create new app**.
3. Enter the app name (for example, `Cakewalk`).
4. Select **MCP app** as the app type.
5. Click **Create app**.

You land on the app's configuration page. The Client ID and Client secret appear at the top. Leave the page open.

## Step 2: Configure the Redirect URL

1. In the left sidebar, click **OAuth**.
2. Under **Redirect URL**, paste this URL:

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

3. Save.

## Step 3: Configure Workspace Access

1. In the left sidebar, click **Manage distribution**.
2. Under **Distribution method**, choose **Specific workspaces**.
3. Add your company's Asana workspace.
4. Save changes.

Specific workspaces keeps the app scoped to your workspace only. The alternative, **Any workspace**, requires Asana review and is not needed here.

## Step 4: Paste Credentials Into Cakewalk

1. Back on the Asana app's main configuration page, copy the **Client ID** and **Client secret**.
2. Open <https://app.getcakewalk.io>.
3. Go to All Connections.
4. Find Asana.
5. Click Edit credentials.
6. Paste the Client ID and Client secret.
7. Save.

## Verifying It Works

The Asana Connection card flips to Active on All Connections. From an agent platform connected to Cakewalk, ask the agent to list your recent Asana tasks. If Asana returns results, the Connection is live.

## Troubleshooting

* `This app is not available to your Asana workspace or organization`: open Manage distribution, confirm Specific workspaces is the chosen method, and confirm your workspace is on the list.
* `Invalid scope(s) requested`: do not configure a custom scope on the Asana app. The MCP server uses the default scope and rejects requests that pass an explicit scope value.
* Redirect URI mismatch on consent: the value under Redirect URL must match `https://mcp-gateway.getcakewalk.io/api/v1/Auth/Callback` exactly, with no trailing slash.

## Learn More

* [Integrating with Asana's MCP Server](https://developers.asana.com/docs/integrating-with-asanas-mcp-server)
* [Asana OAuth documentation](https://developers.asana.com/docs/oauth)


---

# Agent Instructions: 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:

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

The question should be specific, self-contained, and written in natural language.
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.