## Set up the Asana connector

Configure the Asana connector in [AI Studio](https://app.writer.com/aistudio) under **Connectors & Tools**. The Asana connector supports two authentication options:

- **WRITER-managed OAuth** (recommended): Writer provides the OAuth application. No setup required - just authorize access to your Asana workspace.
- **Organization-managed OAuth**: Create your own Asana OAuth application for custom branding and control.

Most users should choose WRITER-managed OAuth for faster setup. Only use organization-managed OAuth if you need custom branding or have specific security requirements.

### Create an Asana OAuth application (organization-managed only)

If you choose to create a self-managed OAuth application to connect, create an MCP app in the Asana developer console:

1. Navigate to the [Asana developer console](https://app.asana.com/0/developer-console) and sign in
2. Select **Create new app**
3. Enter your app name (for example, “My MCP Client”)
4. Select **MCP app** as the app type
5. Select **Create app**
6. In the left sidebar, select **OAuth** and add the Writer redirect URI to Redirect URLs:

```
   https://app.writer.com/mcp/oauth/callback
   ```
   
   If your organization is deployed in the EU, use `https://app.eu2.writer.com/mcp/oauth/callback` instead.

7. In the left sidebar, select **Manage distribution**. Under **Distribution method**, choose **Specific workspaces** (and add at least one workspace) or **Any workspace**, then select **Save changes**
8. Navigate to **Basic information** and copy the **Client ID** and **Client secret** for use in [AI Studio](https://dev.writer.com/connectors/asana#configure-the-connector-in-ai-studio)

For more information, see [Integrating with Asana’s MCP Server](https://developers.asana.com/docs/integrating-with-asanas-mcp-server) documentation.

### Configure the connector in AI Studio

1. Navigate to **Connectors & Tools** in [AI Studio](https://app.writer.com/aistudio)
2. Select the Asana connector
3. Select who has access by default (all users or specific teams)
4. Select the connection type:
   - **Level**: User level (each user authenticates their own account) or org level (shared connection to a single account)
   - **Managed by**: WRITER-managed or self-managed (your own OAuth app)
5. Select which tools to enable for your agents
6. Enter your OAuth client ID and client secret (if using self-managed OAuth)
7. Complete the OAuth authorization flow

## Next steps

- [Set up connectors](https://support.writer.com/article/299-setting-up-connectors): Learn how to configure and enable connectors in AI Studio
- [Tool calling guide](https://dev.writer.com/home/tool-calling): Understand how AI agents use tools in conversations
- [WRITER Agent guide](https://support.writer.com/article/293-how-to-use-action-agent): Learn how to use WRITER Agent with connected tools
- [MCP gateway overview](https://dev.writer.com/home/mcp-gateway): Learn about Writer’s MCP gateway architecture