openai-apps-sdk

Directory structure

skills/openai-apps-sdk/
  SKILL.md
  references/
    concepts/
      README.md
      quickstart.md
      plugin-architecture.md
      mcp-server.md
      plugin-skills.md
      ui-guidelines.md
      plan-use-cases.md
      define-tools.md
    build/
      README.md
      app-quickstart.md
      mcp-server.md
      chatgpt-ui.md
      auth.md
      build-skills.md
      package-plugin.md
      checkout-monetization.md
    reference/
      README.md
      window-openai-bridge.md
      file-apis.md
      host-backed-navigation.md
      tool-descriptor-meta.md
      tool-annotations.md
      component-resource-meta.md
      tool-results.md
      client-provided-meta.md
    deploy/
      README.md
      connect-and-test.md
      review-requirements.md
      submission.md
      submission-errors.md
      troubleshooting.md
      app-guidelines.md
    guides/
      README.md
      optimize-metadata.md
      security-privacy.md
  samples/
    README.md
    minimal-mcp-server.md
    tool-with-ui-resource.md
    window-openai-state.md
    oauth-auth-flow.md
    file-input-tool.md
    checkout-flow.md
    read-only-annotations.md
  scripts/
    README.md
    install.md
    local-dev-and-inspector.md
    package-and-marketplace.md

Exploration procedure

Derive the category from the task, and identify the target page in the category's README.md:

1. Find the category corresponding to the task in the mapping table below
2. For that category, references/{category}/README.md(or samples/README.md / scripts/README.md) to identify the target page
3. Read the .md of the relevant page to check the details

concepts/mcp-server.md と build/mcp-server.md、concepts/quickstart.md と build/app-quickstart.md is a different page with the same or a similar name.concepts covers "what an MCP server exposes and the concept of the invocation flow," andbuild covers "the actual work of implementation, returning results, authentication, and deployment." Determine the category based on whether the goal is conceptual understanding or implementation.

Task → Category Mapping

Task	Category	Reference README
Want to understand the shape of plugins (skills/MCP/UI), want to know the components of an MCP server	concepts	references/concepts/README.md
Want to connect to ChatGPT and try it as a personal plugin	concepts	references/concepts/README.md
Want to design tool definition contracts (read/write, safety annotation)	concepts	references/concepts/README.md
Want to implement an MCP server and build out tools, result returns, and deployment	build	references/build/README.md
Want to add UI (iframe / window.openai extensions) via the MCP Apps bridge	build	references/build/README.md
Want to implement OAuth 2.1 authentication, the plugin.json manifest, and billing (checkout)	build	references/build/README.md
window.openai API・_meta Want to look up the detailed signatures of fields and tool annotations	reference	references/reference/README.md
Want to look up the specifications of the file upload API and host-integration navigation	reference	references/reference/README.md
Want to know about connection testing to ChatGPT, review requirements, and the submission form	deploy	references/deploy/README.md
Want to look up error codes and troubleshooting for plugin submission	deploy	references/deploy/README.md
Want to optimize the metadata for tool names, descriptions, and parameters	guides	references/guides/README.md
Want to check security, privacy, and prompt injection countermeasures	guides	references/guides/README.md
Want to know typical usage (working MCP server / UI resources / OAuth / Checkout examples)	samples	samples/README.md
Want to know about installation, local development, packaging, and marketplace CLI commands	scripts	scripts/README.md