> For the complete documentation index, see [llms.txt](https://docs.startdeliver.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.startdeliver.io/jecta-agent-and-ai/mcp-model-context-protocol.md).

# MCP - Model Context Protocol

**Where to find it:** Settings → MCP **Who can access it:** All users. Admins control available permissions and scopes.

***

### Connecting AI tools via MCP

Startdeliver exposes an MCP server that lets AI tools and assistants connect to your customer data.

### What it does

Once connected, an AI tool can read customers, tasks, and projects, and take actions within the permissions you grant.

MCP works with AI tools and assistants that support MCP or custom connectors.

Claude, Claude Code, and ChatGPT are common examples.

***

### Permissions

Authentication uses standard OAuth.

Admins control which scopes are available — users can only grant what admins have permitted.

***

### How to connect

#### Option 1 — Connect by URL

Use this when your AI tool supports OAuth sign-in flows.

1. Copy the MCP server URL: `https://mcp.startdeliver.com/mcp`
2. Add it as a custom connector in your AI tool
3. On first connection, you will be prompted to authenticate via OAuth and approve permissions

In Claude, adding a custom connector is limited to admins or organization owners.

→ [Full setup guide](https://app.startdeliver.com/dev/tutorial/mcp-server)

***

#### Option 2 — Bearer Token

Use this when your AI tool does not support OAuth.

1. Go to **Settings → MCP**
2. Generate an API key and select the permissions it should have
3. Paste the key directly into your AI tool

→ [Full setup guide](https://app.startdeliver.com/dev/tutorial/mcp-server)

***

### Troubleshooting

#### Connection not working

Check that the OAuth scopes you need are enabled by your admin. Users cannot grant permissions that admins have not permitted.

#### AI not seeing customer data

Verify that the correct read scopes were approved during the OAuth consent step. If unsure, disconnect and reconnect to go through the consent screen again.


---

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

```
GET https://docs.startdeliver.io/jecta-agent-and-ai/mcp-model-context-protocol.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.