feat(catalog): Revamp by cloudjumpercat · Pull Request #6586 · Kong/developer.konghq.com

cloudjumpercat · 2026-08-06T21:55:52Z

Description

Fixes #5413

TODO:

app/_landing_pages/catalog.yaml: FAQ about migration, banner currently renders weird don't use the include and create a separate one for just this page that is text that is all a link similar to /dev-portal.yaml
app/_landing_pages/catalog-classic.yaml: probably also needs the same fix for the note as the other landing page.
app/_landing_pages/catalog.yaml: and app/_landing_pages/catalog-classic.yaml: FAQ that's an include about the difference between classic and new catalog with a link to the migraiton content
all the classic pages will need their breadcrumbs and permalinks looked at. Ex. the GitHub integration one is using /catalog/ in the breadcrumbs and that should probably be /catalog-classic/, which also means I think that we're going to need redirects.
_indices/catalog.yaml: the Classic pages should be moved to their own Classic section but retain the subsections that they are currently in (ex. Services and scorecards will move to the Classic section), also be sure to add the Classic landing page
app/_how-tos/catalog/monitor-sonarqube-projects-with-konnect-ui.md check this one
new UI means we have to change some things as MCP registries is included in this release
complete AI Models page https://docs.google.com/document/d/1W17b_7OJTsEnw_FoYVun2JOk55ipYlwl4vyHRYfMn3A/edit?tab=t.0#heading=h.gfoe2totyqbx
index with how tos in catalog classic section may need to be combed through

Open questions:

when you link to an AI gateway model, you can add any provider, even if the linked Model doesn't have that provider in it's config
MCP registry publishing?

Preview Links

Checklist

Tested how-to docs. If not, note why here.
All pages contain metadata.
Any new docs link to existing docs.
All autogenerated instructions render correctly (API, decK, Konnect, Kong Manager).
Style guide (capitalized gateway entities, placeholder URLs) implemented correctly.
Every page has a description entry in frontmatter.
Add new pages to the product documentation index (if applicable).

Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>

netlify · 2026-08-06T21:55:57Z

✅ Deploy Preview for kongdeveloper ready!

Name	Link
🔨 Latest commit	`1f7b89b`
🔍 Latest deploy log	https://app.netlify.com/projects/kongdeveloper/deploys/6a7e038f42a77a0008662cd3
😎 Deploy Preview	https://deploy-preview-6586--kongdeveloper.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.
🤖 Make changes	Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

… about differences to catalog landing page, content about differences on the classic landing page Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>

…e some in UI step links Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>

DaniellaFreese · 2026-08-12T14:52:42Z

+{% endnavtab %}
+{% endnavtabs %}
+
+## AI Model analytics


FYI - AI Gateway 2.0 is still bootstrapping the analytics, so we have placeholders in the UI but data is not populating atm.

@cloudjumpercat Do we think it still makes sense to leave this here? To give you a sense of timelines, the AI Gateway team is hoping to get Analytics for their 2.0 object-model shipped by end-September.

That said, we (as in, Catalog team) are shipping the UI widget already. Users will just see blank dashes ("-") instead of populated numbers.

DaniellaFreese · 2026-08-12T15:16:32Z

+Add the providers and target models that this AI Model routes to by sending a POST request to the `/ai-models/{aiModelId}/versions` endpoint:
+<!--vale off-->
+{% konnect_api_request %}
+url: /v1/ai-models/$AI_MODEL_ID/versions


add version field to this request:

{ "version": "1.0.0", "target_models": [ {} ] }

miko-bautista · 2026-08-12T18:08:56Z


  - header:
        type: h2
        text: "Create your catalog"


Could we reorder these cards to: APIs -> API Packages -> AI Models -> MCP Registries (tech preview)?

miko-bautista · 2026-08-12T18:09:29Z

+                  key: solution
+              rows:
+                - usecase: |
+                    You need to know every AI model, API, and MCP server your org has built, without checking each team's tools individually


"...know every API, AI Model, and MCP server..."

miko-bautista · 2026-08-12T18:12:02Z

-              - q: "What if I notice discrepancies in {{site.konnect_catalog}} data?"
-                a: "Check integration settings, verify connected tools, and ensure data synchronization is working correctly."
+              - q: "What's different between {{site.konnect_catalog}} and {{site.konnect_catalog}} Classic?"
+                a: "{{site.konnect_catalog}} is the unified, platform-level experience for APIs, API packages, AI Models, and MCP Registries (tech preview) today, with more interface types coming. {{site.konnect_catalog}} Classic remains available with Services, Scorecards, and Integrations. See [Migrate to the new Catalog](/catalog-classic/#migrate-to-the-new-catalog) for how to move to the new experience."


"Classic remains available with Services, Scorecards, and Integrations." -> "Classic remains available with Services."

We do want to eventually bring Scorecards and Integrations back in the new Catalog experience.

miko-bautista · 2026-08-12T18:12:26Z

-                a: "Check integration settings, verify connected tools, and ensure data synchronization is working correctly."
+              - q: "What's different between {{site.konnect_catalog}} and {{site.konnect_catalog}} Classic?"
+                a: "{{site.konnect_catalog}} is the unified, platform-level experience for APIs, API packages, AI Models, and MCP Registries (tech preview) today, with more interface types coming. {{site.konnect_catalog}} Classic remains available with Services, Scorecards, and Integrations. See [Migrate to the new Catalog](/catalog-classic/#migrate-to-the-new-catalog) for how to move to the new experience."
+              - q: "What happened to Services, Integrations, and Scorecards?"


"What happens to Integrations and Scorecards?"

And then, could we instead explain that Integrations and Scorecards will eventually be brought back into the new Catalog experience, but with a focus on APIs & AI interfaces, rather than Services?

(Probably needs some wordsmithing.)

miko-bautista · 2026-08-12T18:16:15Z

+
  - header:
      type: h2
      text: "Frequently asked questions"


Should we explain how an Org Admin can toggle between the old Service Catalog and the new Catalog experience? To do so, they have to enable the toggle under Organization > Settings > Catalog.

Nevermind! I see that you already cover this in the Konnect Catalog Classic page.

miko-bautista · 2026-08-12T18:28:16Z


 An MCP server can define multiple packages and multiple remotes simultaneously. This allows organizations to support different runtime environments without duplicating server definitions.

+## Publish an MCP Registry to Dev Portal


I'd take this out. The MCP Registry (Tech Preview) object won't be publishable to Portal.

The new MCP Server object that we're launching into GA by end-September, though, will be publishable to Portal. Timeline for the Portal publishing bit specifically needs to be confirmed with Jason/Nathanael.

miko-bautista · 2026-08-12T18:31:51Z

+   1. To manually define providers and models, select **Add manually**.
+   1. To import an existing gateway-defined model, select **Import from AI gateway**, then:
+      1. From the **AI gateway** dropdown menu, select your {{site.ai_gateway}} control plane.
+      1. From the **Model from AI gateway** dropdown menu, select the model you want to import.


I feel like we should link out into AI Gateway's documentation for their AI Model object.

miko-bautista · 2026-08-12T18:34:26Z

+    url: /ai-gateway/
+---
+
+An AI Model is an interface in {{site.konnect_catalog}} that represents the providers and target models your organization routes requests to, along with the OpenAPI spec that describes how to call it.


We should explain what it actually means for an AI Model in Catalog to be "linked" to an AI Model in AI Gateway. When the two are linked, it means traffic to that Catalog entity is protected by AI Gateway.

The same principle apply to MCP Servers and Agents too.

Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>

initial new landing pages/classic naming and UI fixes

ab9999b

Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>

cloudjumpercat added do not merge Issues/ PRs whose changes should not be merged at this time release-docs Docs for release labels Aug 6, 2026

cloudjumpercat added 2 commits August 7, 2026 14:12

update classic page breadcrumbs, fix notes on landing pages, add note…

6cc5be1

… about differences to catalog landing page, content about differences on the classic landing page Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>

fix mcp registries so they apply to new catalog, add ai models, revis…

092a3b1

…e some in UI step links Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>

DaniellaFreese reviewed Aug 12, 2026

View reviewed changes

miko-bautista reviewed Aug 12, 2026

View reviewed changes

apply feedback fixes

1f7b89b

Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>


		An MCP server can define multiple packages and multiple remotes simultaneously. This allows organizations to support different runtime environments without duplicating server definitions.

		## Publish an MCP Registry to Dev Portal

Uh oh!

Conversation

cloudjumpercat commented Aug 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Preview Links

Checklist

Uh oh!

netlify Bot commented Aug 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for kongdeveloper ready!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

cloudjumpercat commented Aug 6, 2026 •

edited

Loading

netlify Bot commented Aug 6, 2026 •

edited

Loading