> For the complete documentation index, see [llms.txt](https://docs.taskade.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.taskade.com/developers/workspace-mcp/run-your-app-with-ai.md).

# Run your live app by talking to Claude

You built your business app with Genesis. Now operate it in plain English: read your records, update fields, mark work done, and flag what needs attention — by talking to Claude (or any AI client) through [**Workspace MCP**](/developers/workspace-mcp.md).

## What you'll need

* [**Workspace MCP**](/developers/workspace-mcp.md) connected to your AI client (one-time setup).
* Your Taskade personal token from <https://www.taskade.com/settings/api>.
* The link to your Genesis app (the project it's built on).

## 1. Point your assistant at your app

You don't need to copy any ID out of a URL. Paste your app's link and ask:

> "Here's my app: . Find this project and show me what's inside."

Your assistant resolves the project for you and lists its contents.

## 2. Read your business

> "Show me every overdue job."
>
> "What's the status of the Johnson project?"
>
> "List this week's new client intakes."

## 3. Update records and fields

> "Mark the Johnson job complete and set the next service date to next Friday."
>
> "Log this invoice against the Acme account."
>
> "Add a 'priority' field to overdue tasks and set it to High."

## 4. Let it keep watch

> "Flag anything overdue and tell me what needs my attention today."

## What this changes — and what it doesn't

This guide uses **Workspace MCP**, which reads and writes your app's **content** — the projects, tasks, fields, and records your business runs on.

{% hint style="info" %}
It does **not** edit your app's deployed design or layout. To change your app's pages, components, or styles, use the Genesis builder or [**Genesis App MCP**](/developers/workspace-mcp/genesis-app-mcp.md) — which edits your app's *code* and keeps content read-only.
{% endhint %}

## Next steps

* New to MCP? Start with [**Workspace MCP**](/developers/workspace-mcp.md).
* Want your agents to reach Slack, Shopify, or Gmail? See [**MCP Connectors**](/developers/mcp-connectors.md).


---

# 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://docs.taskade.com/developers/workspace-mcp/run-your-app-with-ai.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.