From afaa1f0ebe913b2bf0ca3684f056cba1c8c938ca Mon Sep 17 00:00:00 2001 From: Dusan Vystrcil Date: Fri, 4 Sep 2026 11:03:07 +0200 Subject: [PATCH] Prepare plugin for OpenAI directory submission - Wrap .mcp.json in mcpServers (validator requirement) - Add interface.defaultPrompt starter prompts - Shorten shortDescription to 30 chars - Bump version to 1.1.0 to match CHANGELOG - README: all tools require authentication with the default tool set Co-Authored-By: Claude Fable 5.1 --- CHANGELOG.md | 11 +++++++++++ README.md | 4 ++-- apify/.codex-plugin/plugin.json | 9 +++++++-- apify/.mcp.json | 6 ++++-- 4 files changed, 24 insertions(+), 6 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 40245b0..1f269ac 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -4,6 +4,17 @@ All notable changes to the **Apify for Codex** plugin are documented in this fil The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). +## [1.1.0] + +### Changed +- `.mcp.json` now uses the `mcpServers` wrapper required by the OpenAI plugin validator (Codex accepts both shapes). +- Shortened `interface.shortDescription` to fit the 30-character directory limit. +- Bumped manifest `version` to match this changelog. +- README: the hosted MCP server requires authentication for all tools in the plugin's default tool set; removed the claim that read-only tools work without signing in. + +### Added +- `interface.defaultPrompt` with three starter prompts (required by the plugin validator and the submission portal). + ## [1.0.1] ### Changed diff --git a/README.md b/README.md index f40192f..63a18c5 100644 --- a/README.md +++ b/README.md @@ -48,7 +48,7 @@ This guide covers installation in both the Codex app and Codex CLI. ## Authenticate to Apify -The plugin bundles the Apify MCP server. Read-only tools such as searching the Store and fetching Actor details work without signing in. Authentication is required to run Actors and access your account data. +The plugin bundles the Apify MCP server. The server requires an authenticated Apify account for every tool, including searching the Store and reading documentation. Codex prompts you to sign in with Apify OAuth when you install the plugin. ### Codex app @@ -58,7 +58,7 @@ The plugin bundles the Apify MCP server. Read-only tools such as searching the S ### Codex CLI -1. The first time Codex calls a tool that requires authentication, such as running an Actor, it opens a browser tab for the Apify OAuth flow. +1. When you install the plugin, or the first time Codex connects to the `apify` MCP server, it opens a browser tab for the Apify OAuth flow. 1. Review the permissions and select **Allow access**. 1. Return to the terminal. The `apify` MCP server is connected and ready to use in any new chat. diff --git a/apify/.codex-plugin/plugin.json b/apify/.codex-plugin/plugin.json index 27c04f8..a8010e9 100644 --- a/apify/.codex-plugin/plugin.json +++ b/apify/.codex-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "apify", - "version": "0.1.0", + "version": "1.1.0", "description": "Run ready-made Actors from Apify, the largest marketplace of tools for AI, or build and publish your own.", "author": { "name": "Apify", @@ -14,11 +14,16 @@ "mcpServers": "./.mcp.json", "interface": { "displayName": "Apify", - "shortDescription": "Apify: the largest marketplace of tools for AI.", + "shortDescription": "Run any Actor from Apify Store", "longDescription": "Run ready-made Actors from Apify, the largest marketplace of tools for AI, or build and publish your own.", "developerName": "Apify", "category": "Productivity", "capabilities": ["Read", "Write"], + "defaultPrompt": [ + "Find 10 highly rated coffee shops in Seattle with name, address, rating, phone, and website.", + "Scrape the latest 50 posts from a public Instagram profile and summarize the main themes.", + "Create an Actor that takes startUrl and maxPages, crawls the site, and stores each page title and URL." + ], "websiteURL": "https://apify.com", "privacyPolicyURL": "https://apify.com/privacy-policy", "termsOfServiceURL": "https://apify.com/terms-of-use", diff --git a/apify/.mcp.json b/apify/.mcp.json index aad28d3..595fc35 100644 --- a/apify/.mcp.json +++ b/apify/.mcp.json @@ -1,5 +1,7 @@ { - "apify": { - "url": "https://mcp.apify.com/?client=codex+plugin" + "mcpServers": { + "apify": { + "url": "https://mcp.apify.com/?client=codex+plugin" + } } }