You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit a9fa8d0
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: content/claude/build/overview.md
+28-28Lines changed: 28 additions & 28 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,54 +6,54 @@
6
6
7
7
> 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.
8
8
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:
10
10
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
15
15
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.
17
17
18
18
## Choose a starting page
19
19
20
-
> **[Build a plugin](/docs/plugins/build.md)**
20
+
> **[Build a plugin](https://claude.com/docs/plugins/build.md)**
21
21
>
22
22
> Lay out the plugin folder and manifest, write the skills, reference your MCP server, and test the plugin in Claude.
> Have your MCP server show interactive components in the conversation with MCP Apps. Optional.
35
35
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)**
37
37
>
38
38
> 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.
39
39
40
40
> [!NOTE]
41
41
>
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)
45
45
> * 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
46
46
47
47
## Steps to build and publish a plugin
48
48
49
49
Building and publishing a plugin follows these steps in order:
50
50
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).
57
57
7.**Measure**: after people have it, [see whether they use it](#measure-usage-of-what-you-built).
58
58
59
59
### 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
64
64
***[`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
65
65
***[`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
66
66
***[`/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
68
68
***[`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
69
69
70
70
## Measure usage of what you built
71
71
72
72
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:
73
73
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
76
76
***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**
78
78
79
79
## Next steps
80
80
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