A bunch of improvements

[rb0000]

Consolidate integrations and connectors (soon to move connetors to own section and reference it from mcp servers and agents)

add lovable how to

clean up some redundant info in agent builder details

[greptile-apps]

Greptile Summary

This PR consolidates navigation by moving the "Integrations" section into the "Document Collections" sub-section under Add Connectors, rewrites several agent documentation pages (collaboration, testing, Slack deployment examples), activates a previously hidden "Credal MCP Servers" connector page, adds a new "Agents and MCP Servers" deployment page, and adds Lovable as an MCP client option. The majority of changes are high-quality improvements, but one structural change introduces a breaking issue:

• Broken links from deleted page: data-sources.mdx is deleted but its former URL (/user-guide/platform/integrations/data-sources-action-providers) is still linked from 6 pages (introduction.mdx, faqs.mdx, bring-your-own-data.mdx, mcp-servers/overview.mdx, tutorials/it-security/use-data.mdx, tutorials/it-security/connect-to-jira.mdx). These will all 404 for users. The integration reference table it contained (listing supported data sources/action providers) has also been removed without a replacement destination.
• Stub page now live: connectors/mcp-servers.mdx was previously commented out and is now published as a navigable page, but its content is a generic placeholder that doesn't link to the comprehensive MCP Servers section already in the docs.

Confidence Score: 2/5

• Not safe to merge as-is due to 6 broken links caused by the deletion of data-sources.mdx.
• The content improvements are solid, but deleting data-sources.mdx without updating the 6 pages that still link to its slug will produce visible 404s on the live docs site across high-traffic pages like Introduction, FAQs, and tutorial pages.
• fern/docs/pages/platform/integrations/data-sources.mdx (deleted) — its inbound links in introduction.mdx, faqs.mdx, bring-your-own-data.mdx, mcp-servers/overview.mdx, and two IT security tutorial pages all need to be updated or redirected before merging.

Important Files Changed

Filename	Overview
fern/docs/pages/platform/integrations/data-sources.mdx	File deleted — removes the supported-integrations reference table and breaks 6 inbound links that still point to the old slug /user-guide/platform/integrations/data-sources-action-providers.
fern/docs/user-guide.yml	Navigation restructured: "Integrations" section removed, its sub-pages moved under "Document Collections" within Add Connectors; new "Agents and MCP Servers" page added; previously commented-out "Credal MCP Servers" connector page now active (but that page is a stub).
fern/docs/pages/platform/agents/configure-steps/connectors/mcp-servers.mdx	Previously hidden stub page now live in navigation; content is generic placeholder with no links to the comprehensive MCP Servers section of the docs.
fern/docs/pages/platform/agents/configure-steps/agent-collaboration.mdx	Substantially rewritten with a thorough orchestrator-subagent guide, clear step-by-step instructions, and best practices. No issues found.
fern/docs/pages/platform/agents/deployment/agents-and-mcp-servers.mdx	New page documenting how to publish agents for use in MCP servers; content is clear and well-structured with a new screenshot asset.
fern/docs/pages/platform/mcp-servers/publishing-server.mdx	Adds Lovable MCP client entry with a direct URL. The URL is provided but setup steps inside Lovable's UI are not described (flagged in a previous review thread).
fern/docs/pages/platform/agents/agent-testing.mdx	Rewritten to focus on practical testing workflows (UI testing, Slack beta channels, iterating on instructions); content is cleaner and more actionable than the original.

Comments Outside Diff (2)

1. fern/docs/pages/platform/integrations/data-sources.mdx

   Deleting this file breaks 6 inbound links

   This file was served at the URL /user-guide/platform/integrations/data-sources-action-providers (Fern slugifies the nav entry "Data Sources / Action Providers"). After deletion the following pages will all produce broken links for users:

   • fern/docs/pages/introduction.mdx:43 — [enterprise data sources](/user-guide/platform/integrations/data-sources-action-providers)
   • fern/docs/pages/getting-started/faqs.mdx:45 — [_out-of-the-box integrations_](/user-guide/platform/integrations/data-sources-action-providers)
   • fern/docs/pages/tutorials/it-security/use-data.mdx:3 — [Data Sources](/user-guide/platform/integrations/data-sources-action-providers)
   • fern/docs/pages/tutorials/it-security/connect-to-jira.mdx:7 — [Action Provider](/user-guide/platform/integrations/data-sources-action-providers)
   • fern/docs/pages/platform/mcp-servers/overview.mdx:9 — [data sources](/user-guide/platform/integrations/data-sources-action-providers)
   • fern/docs/pages/platform/integrations/bring-your-own-data.mdx:3 — [out-of-the-box support](/user-guide/platform/integrations/data-sources-action-providers)

   The supported-integrations table (Slack, Confluence, Google Drive, Salesforce, etc.) has also been removed without being migrated to a replacement page. Before merging, either update all 6 links to point to a new equivalent page, or restore the deleted content at a routable path.

2. fern/docs/pages/platform/agents/configure-steps/connectors/mcp-servers.mdx, line 33-35 (link)

   Stub page now exposed in the nav

   This file was previously commented out in user-guide.yml and is now published live as "Credal MCP Servers" under the Add Connectors section. Its current content is a generic placeholder that ends with "contact your Credal administrator or reach out to support@credal.ai" and provides no links to the full MCP Servers section of the docs.

   Now that users will see this page in the sidebar, consider adding a direct link to the existing, comprehensive MCP Servers section, and ideally a short description of how to attach an MCP server to an agent (e.g., linking to "Create a new Server" and "Attaching connectors" pages that already exist).

   _{Note: If this suggestion doesn't match your team's coding style, reply to this and let me know. I'll remember it for next time!}

Prompt To Fix All With AI

This is a comment left during a code review.
Path: fern/docs/pages/platform/integrations/data-sources.mdx
Line: 1-30

Comment:
**Deleting this file breaks 6 inbound links**

This file was served at the URL `/user-guide/platform/integrations/data-sources-action-providers` (Fern slugifies the nav entry "Data Sources / Action Providers"). After deletion the following pages will all produce broken links for users:

- `fern/docs/pages/introduction.mdx:43` — `[enterprise data sources](/user-guide/platform/integrations/data-sources-action-providers)`
- `fern/docs/pages/getting-started/faqs.mdx:45` — `[_out-of-the-box integrations_](/user-guide/platform/integrations/data-sources-action-providers)`
- `fern/docs/pages/tutorials/it-security/use-data.mdx:3` — `[Data Sources](/user-guide/platform/integrations/data-sources-action-providers)`
- `fern/docs/pages/tutorials/it-security/connect-to-jira.mdx:7` — `[Action Provider](/user-guide/platform/integrations/data-sources-action-providers)`
- `fern/docs/pages/platform/mcp-servers/overview.mdx:9` — `[data sources](/user-guide/platform/integrations/data-sources-action-providers)`
- `fern/docs/pages/platform/integrations/bring-your-own-data.mdx:3` — `[out-of-the-box support](/user-guide/platform/integrations/data-sources-action-providers)`

The supported-integrations table (Slack, Confluence, Google Drive, Salesforce, etc.) has also been removed without being migrated to a replacement page. Before merging, either update all 6 links to point to a new equivalent page, or restore the deleted content at a routable path.

How can I resolve this? If you propose a fix, please make it concise.

---

This is a comment left during a code review.
Path: fern/docs/pages/platform/agents/configure-steps/connectors/mcp-servers.mdx
Line: 33-35

Comment:
**Stub page now exposed in the nav**

This file was previously commented out in `user-guide.yml` and is now published live as "Credal MCP Servers" under the Add Connectors section. Its current content is a generic placeholder that ends with "contact your Credal administrator or reach out to `support@credal.ai`" and provides no links to the full MCP Servers section of the docs.

Now that users will see this page in the sidebar, consider adding a direct link to the existing, comprehensive [MCP Servers](/user-guide/platform/mcp-servers/overview) section, and ideally a short description of how to attach an MCP server to an agent (e.g., linking to "Create a new Server" and "Attaching connectors" pages that already exist).

How can I resolve this? If you propose a fix, please make it concise.

_{Last reviewed commit: 11532c2}