Skip to content

Commit a9fa8d0

Browse files
github-actions[bot]claude-yolo[bot]
authored andcommitted
docs: Claude Code v2.1.309 - MCP tasks public beta (server-run jobs that survive exit), Claude Tag API beta
Co-Authored-By: claude-yolo[bot] <claude-yolo@lroole.com>
1 parent 1925a67 commit a9fa8d0

888 files changed

Lines changed: 21062 additions & 17721 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎content/.metadata.json‎

Lines changed: 1788 additions & 1772 deletions
Large diffs are not rendered by default.

‎content/claude/build/overview.md‎

Lines changed: 28 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -6,54 +6,54 @@
66

77
> Build a plugin people use inside Claude: an MCP connector to your product, skills for your workflows, optional MCP Apps UI, and a listing in the directory.
88
9-
To bring your product or workflow into Claude, you build a [plugin](/docs/plugins/build.md): a package people add once and then use on claude.ai, in the desktop and mobile apps, in Cowork, and in Claude Code. A plugin packages whatever your integration needs, in any combination, and a plugin with only one of these pieces is complete:
9+
To bring your product or workflow into Claude, you build a [plugin](https://claude.com/docs/plugins/build.md): a package people add once and then use on claude.ai, in the desktop and mobile apps, in Cowork, and in Claude Code. A plugin packages whatever your integration needs, in any combination, and a plugin with only one of these pieces is complete:
1010

11-
* **[An MCP connector](/docs/connectors/building/index.md)**: include one when Claude needs to reach your product or data. It points at an MCP server that you build and host
12-
* **[Skills](/docs/skills/how-to.md)**: include them to teach Claude your workflows, such as the sequence of steps, the defaults, and what good output looks like
13-
* **[An MCP App](/docs/connectors/building/mcp-apps/getting-started.md)**: include one when you want the connector to show interactive UI in the conversation
14-
* **Commands and agents**: include named actions, or specialists Claude can delegate to, which [Plugin structure and testing](/docs/plugins/build.md) covers
11+
* **[An MCP connector](https://claude.com/docs/connectors/building/index.md)**: include one when Claude needs to reach your product or data. It points at an MCP server that you build and host
12+
* **[Skills](https://claude.com/docs/skills/how-to.md)**: include them to teach Claude your workflows, such as the sequence of steps, the defaults, and what good output looks like
13+
* **[An MCP App](https://claude.com/docs/connectors/building/mcp-apps/getting-started.md)**: include one when you want the connector to show interactive UI in the conversation
14+
* **Commands and agents**: include named actions, or specialists Claude can delegate to, which [Plugin structure and testing](https://claude.com/docs/plugins/build.md) covers
1515

16-
When the plugin is ready, you can [submit it](/docs/directory/publish.md) to Anthropic's directory at [claude.ai/directory](https://claude.ai/directory), the catalog inside Claude where people find and add plugins and connectors, so that anyone on a paid plan can add it. Anthropic checks each submission before it's listed, and there's no partner program to apply to first.
16+
When the plugin is ready, you can [submit it](https://claude.com/docs/directory/publish.md) to Anthropic's directory at [claude.ai/directory](https://claude.ai/directory), the catalog inside Claude where people find and add plugins and connectors, so that anyone on a paid plan can add it. Anthropic checks each submission before it's listed, and there's no partner program to apply to first.
1717

1818
## Choose a starting page
1919

20-
> **[Build a plugin](/docs/plugins/build.md)**
20+
> **[Build a plugin](https://claude.com/docs/plugins/build.md)**
2121
>
2222
> Lay out the plugin folder and manifest, write the skills, reference your MCP server, and test the plugin in Claude.
2323
24-
> **[Write skills](/docs/skills/how-to.md)**
24+
> **[Write skills](https://claude.com/docs/skills/how-to.md)**
2525
>
2626
> Teach Claude your workflows: the SKILL.md frontmatter, the instructions, reference files, and scripts.
2727
28-
> **[Build an MCP server](/docs/connectors/building/index.md)**
28+
> **[Build an MCP server](https://claude.com/docs/connectors/building/index.md)**
2929
>
3030
> Give the plugin access to your product or data: implement the server, set up authentication for Claude's clients, and test it.
3131
32-
> **[Add interactive UI](/docs/connectors/building/mcp-apps/getting-started.md)**
32+
> **[Add interactive UI](https://claude.com/docs/connectors/building/mcp-apps/getting-started.md)**
3333
>
3434
> Have your MCP server show interactive components in the conversation with MCP Apps. Optional.
3535
36-
> **[Submit your plugin or MCP server](/docs/directory/publish.md)**
36+
> **[Submit your plugin or MCP server](https://claude.com/docs/directory/publish.md)**
3737
>
3838
> List it in Anthropic's directory so anyone can add it: who can submit, what review involves, and the developer portal steps. Submit your MCP server as a connector too, even when your plugin references it.
3939
4040
> [!NOTE]
4141
>
42-
> * If you want to connect a tool or install a plugin for yourself, see the [Customize Claude](/docs/extend/overview.md) tab
43-
> * If you're not sure whether your plugin needs an MCP server at all, see [Decide what to include in your plugin](/docs/connectors/building/what-to-build.md)
44-
> * If you're distributing only inside your organization, see [Roll out a plugin to your whole organization](/docs/plugins/org-rollout.md)
42+
> * If you want to connect a tool or install a plugin for yourself, see the [Customize Claude](https://claude.com/docs/extend/overview.md) tab
43+
> * If you're not sure whether your plugin needs an MCP server at all, see [Decide what to include in your plugin](https://claude.com/docs/connectors/building/what-to-build.md)
44+
> * If you're distributing only inside your organization, see [Roll out a plugin to your whole organization](https://claude.com/docs/plugins/org-rollout.md)
4545
> * If you're building only for Claude Code's terminal and IDE users, see the [Claude Code plugin docs](https://code.claude.com/docs/en/plugins/create), which cover what that surface alone supports
4646
4747
## Steps to build and publish a plugin
4848

4949
Building and publishing a plugin follows these steps in order:
5050

51-
1. **Lay out the plugin**: create the folder and manifest and reference any MCP server it uses. Start with [Build your first plugin](/docs/plugins/quickstart.md) if you haven't made one before, or [Plugin structure and testing](/docs/plugins/build.md) for the full layout. Chat, Cowork, and Claude Code each load different parts of a plugin, so check [Plugin feature support across platforms](/docs/plugins/platform-support.md) before you commit to a design.
52-
2. **Write the skills**: teach Claude your workflows in `SKILL.md` files inside the plugin. [Create a skill](/docs/skills/how-to.md) covers the frontmatter, the instructions, reference files, and scripts
53-
3. **Build the MCP server**: if the plugin needs to reach your product or data, implement the server, get authentication right for Claude's clients, and test it against Claude. Start with [Build an MCP server for Claude](/docs/connectors/building/index.md), or with [Build your first MCP server for Claude](/docs/connectors/building/quickstart.md) if you haven't written one before. A local server can also be packaged as a [desktop extension](/docs/connectors/building/mcpb.md).
54-
4. **Add interactive UI**: if you want your server to show interactive components in the conversation, build them with [MCP Apps](/docs/connectors/building/mcp-apps/getting-started.md). This step is optional.
55-
5. **Test it**: try the plugin in Claude before you publish it. [Test the plugin on each surface](/docs/plugins/build.md#test-the-plugin-on-each-surface) covers claude.ai, Cowork, and Claude Code, and [Test your MCP server](/docs/connectors/building/testing.md) covers adding your server as a custom connector
56-
6. **Publish**: submit the plugin to the directory, submit its MCP server as a connector, and maintain the listing. Start with [Publish to the directory](/docs/directory/publish.md).
51+
1. **Lay out the plugin**: create the folder and manifest and reference any MCP server it uses. Start with [Build your first plugin](https://claude.com/docs/plugins/quickstart.md) if you haven't made one before, or [Plugin structure and testing](https://claude.com/docs/plugins/build.md) for the full layout. Chat, Cowork, and Claude Code each load different parts of a plugin, so check [Plugin feature support across platforms](https://claude.com/docs/plugins/platform-support.md) before you commit to a design.
52+
2. **Write the skills**: teach Claude your workflows in `SKILL.md` files inside the plugin. [Create a skill](https://claude.com/docs/skills/how-to.md) covers the frontmatter, the instructions, reference files, and scripts
53+
3. **Build the MCP server**: if the plugin needs to reach your product or data, implement the server, get authentication right for Claude's clients, and test it against Claude. Start with [Build an MCP server for Claude](https://claude.com/docs/connectors/building/index.md), or with [Build your first MCP server for Claude](https://claude.com/docs/connectors/building/quickstart.md) if you haven't written one before. A local server can also be packaged as a [desktop extension](https://claude.com/docs/connectors/building/mcpb.md).
54+
4. **Add interactive UI**: if you want your server to show interactive components in the conversation, build them with [MCP Apps](https://claude.com/docs/connectors/building/mcp-apps/getting-started.md). This step is optional.
55+
5. **Test it**: try the plugin in Claude before you publish it. [Test the plugin on each surface](https://claude.com/docs/plugins/build.md#test-the-plugin-on-each-surface) covers claude.ai, Cowork, and Claude Code, and [Test your MCP server](https://claude.com/docs/connectors/building/testing.md) covers adding your server as a custom connector
56+
6. **Publish**: submit the plugin to the directory, submit its MCP server as a connector, and maintain the listing. Start with [Publish to the directory](https://claude.com/docs/directory/publish.md).
5757
7. **Measure**: after people have it, [see whether they use it](#measure-usage-of-what-you-built).
5858

5959
### Tools that help you build and check a plugin
@@ -64,21 +64,21 @@ Most of the tooling for building and checking a plugin lives in [Claude Code](ht
6464
* **[`claude --plugin-dir`](https://code.claude.com/docs/en/plugins/create#load-a-directory-or-archive-for-one-session)**: start Claude Code with your plugin loaded from a local folder, so you can try its skills and commands before it's in a repository
6565
* **[`claude plugin eval`](https://code.claude.com/docs/en/plugin-evals)**: run eval cases you write and compare Claude's results with and without your plugin. Each run is a real model call that counts against your plan's usage or your API bill
6666
* **[`/skill-doctor`](https://code.claude.com/docs/en/skills#find-unused-skills)**: in a Claude Code session, see what each installed skill costs in context and how often Claude has invoked it
67-
* **[`skill-creator`](/docs/skills/how-to#measure-whether-the-skill-improves-the-output)**: a skill from Anthropic that drafts a skill with you and runs it on test prompts; available in claude.ai and Claude Code
67+
* **[`skill-creator`](https://claude.com/docs/skills/how-to#measure-whether-the-skill-improves-the-output)**: a skill from Anthropic that drafts a skill with you and runs it on test prompts; available in claude.ai and Claude Code
6868
* **[`plugin-dev`](https://github.com/anthropics/claude-plugins-official/tree/main/plugins/plugin-dev)** and **[`mcp-server-dev`](https://github.com/anthropics/claude-plugins-official/tree/main/plugins/mcp-server-dev)**: plugins Anthropic publishes for Claude Code whose skills walk Claude through building a plugin or an MCP server with you
6969

7070
## Measure usage of what you built
7171

7272
Usage figures for a directory listing are in the developer portal, and figures for a plugin you distribute yourself or inside your organization are in Claude Code or in **Customize**. Each of these pages covers one case:
7373

74-
* **A plugin listed in the directory**: [How a published plugin is used](/docs/connectors/building/after-publishing.md#track-published-plugin-usage) covers installs, versions, how often each skill and MCP server runs, and error rates
75-
* **A connector listed in the directory**: [Manage your directory listing](/docs/connectors/building/managing-your-listing.md#server-health-and-usage-metrics) covers the dashboard's server health, usage by product and by tool, and error breakdown
74+
* **A plugin listed in the directory**: [How a published plugin is used](https://claude.com/docs/connectors/building/after-publishing.md#track-published-plugin-usage) covers installs, versions, how often each skill and MCP server runs, and error rates
75+
* **A connector listed in the directory**: [Manage your directory listing](https://claude.com/docs/connectors/building/managing-your-listing.md#server-health-and-usage-metrics) covers the dashboard's server health, usage by product and by tool, and error breakdown
7676
* **A plugin you rolled out to your organization's Claude Code users**: [Measure and evaluate plugins](https://code.claude.com/docs/en/plugins/measure) covers what a plugin costs in context, whether it's used, and the OpenTelemetry events that answer organization-wide questions
77-
* **A plugin or skill used inside your organization on claude.ai**: [How a plugin is used in your organization](/docs/plugins/overview.md#track-plugin-usage-in-your-organization) covers the adoption and activity figures on its page in **Customize**
77+
* **A plugin or skill used inside your organization on claude.ai**: [How a plugin is used in your organization](https://claude.com/docs/plugins/overview.md#track-plugin-usage-in-your-organization) covers the adoption and activity figures on its page in **Customize**
7878

7979
## Next steps
8080

81-
* [Build your first plugin](/docs/plugins/quickstart.md): build a small example plugin, test it, and push it to GitHub, ready to submit your own
82-
* [Plugin structure and testing](/docs/plugins/build.md): the folder layout, manifest, skills, MCP server reference, and testing
83-
* [Build an MCP server for Claude](/docs/connectors/building/index.md): implement the server, authentication, and testing against Claude
84-
* [Decide what to include in your plugin](/docs/connectors/building/what-to-build.md): decide whether your plugin needs an MCP server, commands, agents, or UI
81+
* [Build your first plugin](https://claude.com/docs/plugins/quickstart.md): build a small example plugin, test it, and push it to GitHub, ready to submit your own
82+
* [Plugin structure and testing](https://claude.com/docs/plugins/build.md): the folder layout, manifest, skills, MCP server reference, and testing
83+
* [Build an MCP server for Claude](https://claude.com/docs/connectors/building/index.md): implement the server, authentication, and testing against Claude
84+
* [Decide what to include in your plugin](https://claude.com/docs/connectors/building/what-to-build.md): decide whether your plugin needs an MCP server, commands, agents, or UI

0 commit comments

Comments
 (0)