# Taylorz CRM Developers

> REST and MCP reference and guides for building on Taylorz CRM.

## Docs

- [Taylorz CRM for developers](https://docs.taylorz.ai/): Build on Taylorz CRM with the REST API and MCP, using OAuth authorization-code grants bound to one organization.

## Guides

- [Guides](https://docs.taylorz.ai/guides): What an endpoint signature cannot tell you: getting a token, the scopes each endpoint needs, and the conventions every request shares.
- [Connect a client](https://docs.taylorz.ai/guides/connect-a-client): Register a public client, authorize a person with PKCE, exchange the code for a token, and keep it fresh — access tokens last five minutes.
- [Conventions](https://docs.taylorz.ai/guides/conventions): Idempotency keys, cursor pagination, optimistic revisions and request limits, described as the server actually behaves rather than as guarantees.
- [Errors](https://docs.taylorz.ai/guides/errors): Both refusal shapes, what each status code means, which refusals are worth retrying, and why a validation failure tells you so little.
- [Public endpoints](https://docs.taylorz.ai/guides/public-endpoints): The published form boundary and the Meta webhook: what they are, why they take no token, and why neither is the interface you build on.
- [Scopes and consent](https://docs.taylorz.ai/guides/scopes): The four checks every request passes: the connection scope, the action scope, the member's role, and whether the workspace has the module on.

## 日本語

### Docs

- [Taylorz CRM 開発者向け](https://docs.taylorz.ai/ja): REST API と MCP で Taylorz CRM 上に構築します。どちらも 1 つの組織に紐づく OAuth アクセストークンを使い、同一のアクション目録の上で動きます。

### Guides

- [ガイド](https://docs.taylorz.ai/ja/guides): エンドポイントのシグネチャだけでは分からないこと。トークンの取得方法、エンドポイントごとに必要なスコープ、そしてすべてのリクエストが共有する規約を扱います。
- [エラー](https://docs.taylorz.ai/ja/guides/errors): 2 つの拒否の形、各ステータスコードの意味、再試行の価値がある拒否、そして検証の失敗がほとんど何も語らない理由を説明します。
- [クライアントを接続する](https://docs.taylorz.ai/ja/guides/connect-a-client): パブリッククライアントを登録し、PKCE で利用者の認可を受け、コードをトークンに交換し、更新し続けます。アクセストークンの有効期間は 5 分です。
- [スコープと同意](https://docs.taylorz.ai/ja/guides/scopes): すべてのリクエストが通る 4 つの検査。接続スコープ、アクションスコープ、メンバーの役割、そしてワークスペースがそのモジュールを有効にしているかどうかです。
- [公開エンドポイント](https://docs.taylorz.ai/ja/guides/public-endpoints): 公開されたフォーム境界と Meta Webhook。それぞれが何であり、なぜトークンを取らず、なぜどちらも構築対象のインターフェースではないのかを説明します。
- [規約](https://docs.taylorz.ai/ja/guides/conventions): 冪等性キー、カーソルページネーション、楽観的リビジョン、リクエスト制限。文書のための保証ではなく、サーバーが実際にどう振る舞うかを記述します。

## Agent skills

- [taylorz-crm-developers](https://docs.taylorz.ai/.well-known/agent-skills/taylorz-crm-developers/SKILL.md): Read the Taylorz CRM Developers docs instead of answering from memory. REST and MCP reference and guides for building on Taylorz CRM. Use when a task involves Taylorz CRM Developers: how it works, how to set it up or configure it, or its API.

## Agent resources

- [llms-full.txt](https://docs.taylorz.ai/llms-full.txt): The full Markdown of every page in one file.
- [Page Markdown](https://docs.taylorz.ai/index.md): Append `.md` to any page URL to fetch that page as raw Markdown.
- [JSON API](https://docs.taylorz.ai/api/docs/pages.json): Page index of the JSON docs API; each entry links the page's JSON and Markdown forms. Described by the OpenAPI document at https://docs.taylorz.ai/openapi.json.
- [MCP server](https://docs.taylorz.ai/mcp): Streamable HTTP Model Context Protocol server with search_docs, get_page, list_pages, and get_navigation tools, plus every page as a resource. Discovery document: https://docs.taylorz.ai/.well-known/mcp.json
- [Agent skills](https://docs.taylorz.ai/.well-known/agent-skills/index.json): Agent Skills discovery index of the skills this site publishes.
- [API catalog](https://docs.taylorz.ai/.well-known/api-catalog): RFC 9727 linkset of the APIs documented here.
- [AI catalog](https://docs.taylorz.ai/.well-known/ai-catalog.json): ARD manifest of the agent-facing resources on this site (MCP server, skills, APIs).
- [agent-readability.json](https://docs.taylorz.ai/agent-readability.json): Manifest of every agent-facing artifact on this site.
- [Sitemap](https://docs.taylorz.ai/sitemap.xml): Every indexable page URL with its last-modified date.