---
title: "Connecting an OAuth-Only Agent"
description: "Use this page when your AI host can add a remote MCP server but cannot send a custom `Authorization` header. Claude Cowork is the common case. The host signs in with OAuth. You still use the API key EasyTerritory issued…"
url: "https://www.easyterritory.com/documentation/ezt-mcp/connecting-oauth-only-agents/"
updated: "2026-11-09"
category: MCP Server
---

# Connecting an OAuth-Only Agent

Use this page when your AI host can add a remote MCP server but cannot send a custom `Authorization` header. Claude Cowork is the common case. The host signs in with OAuth. You still use the API key EasyTerritory issued — you paste it once on the consent page, not into the chat.

Hosts that can set a header should use [Connecting Your AI Agent](/documentation/ezt-mcp/connecting-your-ai-agent/) instead. Both paths use the same server and the same key.

## Before you start

- An AI account on a plan that can add a custom MCP connector.
- An EasyTerritory MCP API key. It starts with `ezt_`. EasyTerritory staff issue it, or [request a free trial](https://www.easyterritory.com/free-trial/).
- Optional: a spreadsheet of account or rep locations, with addresses or latitude and longitude.

## Add the connector

In Claude Cowork, the path is **+**, then **Connectors**, **Add connector**, **Add custom connector**. Other OAuth-only hosts use their own custom-connector screen. The server values are the same.

| Field | Enter |
| --- | --- |
| Name | EZT MCP |
| MCP server URL | `https://mcp.easyterritory.ai` |
| Authentication | Sign in now |
| OAuth client ID and secret | Leave blank. The host registers itself. |

Use `https://mcp.easyterritory.ai/` or `https://mcp.easyterritory.ai/mcp`. Do not use a staging or internal URL.

## Sign in

1. Choose **Connect** on the new connector.
2. Sign in with the AI host if it asks.
3. On the EasyTerritory consent page, paste the API key and choose **Connect**.

You enter the key once. Keep it private. Do not paste it into a chat message. If you have no key, the consent page on `mcp.easyterritory.ai` links to the free trial. The connector then holds a token for that key. Removing the connector disconnects it.

## Build and work with a map

Start a new task and ask in plain language. Attach a spreadsheet before you refer to it. The agent may ask which area or layer to show.

| Try typing | What happens |
| --- | --- |
| Build a map using the EZT MCP | Opens a new EasyTerritory map and returns a link. |
| Open this map in a browser tab | Opens the map so you can watch changes. The agent waits until that tab is connected. |
| Plot the customer locations in this spreadsheet on the map | Geocodes the rows and adds them as a point layer. |
| Plot the sales rep locations in this spreadsheet on the map | Adds the reps as a separate point layer. |
| Plan a daily schedule starting from [address] that visits each of these accounts over the next 30 days. I will spend 30 minutes at each account. | Assigns visits to days and plans the driving route. State the onsite time yourself — the server does not assume 30 minutes. |
| Use each sales rep location as a seed and create a territory around it that balances the customer locations. | Builds one territory per rep, balanced on your customer data. One seed is one territory. |

## Tips

- **The map is not updating.** Open the map link in a browser tab. The agent waits for that tab to connect before it builds.
- **ZIP outlines are missing.** Zoom in. ZIP boundaries are not drawn at a national view.
- **The map link stopped working.** A map session expires after about an hour. Ask the agent to open the map again.
- **Authentication failed.** Reconnect the connector and enter the key again. If it still fails, email [support@easyterritory.com](mailto:support@easyterritory.com).

---

## Next steps

- [Connecting Your AI Agent](/documentation/ezt-mcp/connecting-your-ai-agent/) — Header setup when the host can store an API key.
- [Getting Started](/documentation/ezt-mcp/getting-started-ezt-mcp/) — What a first session looks like.
- [Tools Reference](/documentation/ezt-mcp/mcp-server-tools-reference/) — All 58 tools.