- Organizations: a limited set of organizations has access, so check whether your organization has access
- Connectors: Verified directory connectors and custom connectors can have entry points. Connectors installed from a Community listing can’t.
- Users: a user needs the unified Claude experience, which combines chat and Cowork
If your MCP App doesn’t render in Claude yet, start with Get started with MCP Apps.
Mark a tool as a global entry point
To mark a tool, change its_meta on your server:
- Add the
openai/uikey - Set the key to an object whose
entrypointslist contains aglobalentry - Keep
ui.resourceUriin_metaas well
tools/list result:
_meta object to registerAppTool().
You can mark several tools, and Claude can list one app for each marked tool.
Confirm that Claude lists your app
To test the mark, follow these steps:- Refresh the tools list for your connector
- Open the Artifacts page in Claude on the web
Adapt a tool that declares entry points for another host
If your tool already declares theopenai/ui key for a different host, check that the tool’s _meta also has ui.resourceUri, which Claude needs. The key comes from the OpenAI MCP extensions.
Design the view that people open from an entry point
A view is one rendered instance of your app’s UI in Claude. When a user opens your app from an entry point, the view starts with no request from the user and no existing conversation.- Arguments: make every input optional and show a useful starting state when the arguments are
{}.- Claude can choose a value for an optional input, so don’t treat a value as proof of the user’s choice.
- Conversation: on the web, the app opens in a new conversation each time a user opens it
- Display mode: on the web, Claude shows the view full screen when the view supports
fullscreen, so includefullscreenif you declareavailableDisplayModes.- Without
fullscreen, the view appears in the conversation.
- Without
- Approval: if the tool’s permission is Needs approval, Claude asks the user for approval before the view opens. If the conversation’s permission setting is Auto, Claude can open the view without asking.
Set the title, name, and description of the marked tool
title: set atitle, because Claude displays it with the connector’s name. Use 60 characters or fewer, and leave out Claude’s name and Anthropic’s name.name: don’t put two underscores in a row, two dots in a row, or a dot next to an underscore in thename. With any of these, Claude lists the app but people can’t open it from the entry point.description: write it for conversations too, because Claude can also call the same tool in a conversation where the connector is turned on
Refresh the tools list after you change an entry point
After you add or edit an entry point, the change can take up to about two hours to appear, even after you reload the page. To see the change immediately, refresh the tools list:- Go to Customize > Connectors and select your connector
- Open the three-dot menu and click Refresh tools list
Conditions for showing an app on the Artifacts page
Claude shows no error when it doesn’t list your app on the Artifacts page. If your app isn’t listed, refresh the tools list first, then check each condition. In your server’stools/list result, check the _meta of the tool that you marked:
- Entry point:
_meta["openai/ui"].entrypointscontains{ "type": "global" } - View:
_meta.ui.resourceUripoints to aui://resource - Visible to Claude:
_meta.ui.visibilityis omitted or containsmodel, so that Claude can call the tool
- Remote: the connector is remote, not a local server
- Verified or custom: the connector has the Verified label in the directory, or it’s a custom connector.
- If a user installs the connector from a Community listing, Claude doesn’t show its apps on the Artifacts page or in the sidebar, including pinned apps.
- For what each label means, see Connector verification.
- Unified Claude experience: the user has this experience, which combines chat and Cowork.
- If the message box offers a choice of Chat or Cowork, the account doesn’t have it.
- On Team and Enterprise plans, an Owner or Primary Owner controls it with the Chat and Cowork unified setting in Organization settings > Capabilities.
- Connected: the user has connected the connector
- Turned on: the user hasn’t turned off the connector or set the tool to Blocked
- Allowed by the organization: on Team and Enterprise plans, the organization hasn’t set the tool or the connector to Blocked
- Organization access: the user’s organization has access to entry points
Check whether your organization has access to entry points
To check your own organization, follow these steps:- Refresh the tools list, then reload Claude on the web
- If your app isn’t listed and meets all the other conditions, your organization may not have access
- Keep your app working without an entry point, and test again later
Entry points that appear while you test and stay hidden for other people
An app that you see on the Artifacts page while you test can still be hidden for other people. For example, suppose you add your server by URL and the same server also has a Community listing:- You: you keep the entry point on the connector that you added by URL
- People who install the Community listing: they have no entry point
Next steps
- Show your MCP App in the side panel or full screen: lay out the view for full screen and for the side panel
- Test your connector: add your server as a custom connector and open the app yourself
- Submit a connector: list your connector and its MCP App in the directory