Update Sophia documentation and branding

Author: ujibang

_includes/docs-sidebar.html

@@ -194,7 +194,7 @@ <h3 class="mt-2">RESTHeart Cloud</h3>
 
   <div class="part">
     <a data-bs-toggle="collapse" href="#part-sophia" role="button">
-      <h3 class="mt-2">Sophia AI</h3>
+      <h3 class="mt-2">Sophia</h3>
     </a>
     <ul id="part-sophia" class="collapse">
       <li><a href="/docs/cloud/sophia/">Overview</a></li>

docs/cloud/sophia/index.adoc

@@ -18,7 +18,7 @@ If you're here to learn about RESTHeart or RESTHeart Cloud, Sophia is already wo
 
 === Sophia for Your Organization
 
-Sophia is available as a managed service through *RESTHeart Cloud* in the *dedicated* tier. You get your own Sophia instance, powered by your own knowledge base — with full control over contexts, documents, access, and AI behaviour through the admin panel.
+Sophia is available as a *managed service* through *RESTHeart Cloud* (dedicated tier) or as an *on-premises deployment* on your own infrastructure. Either way, you get your own Sophia instance, powered by your own knowledge base — with full control over contexts, documents, access, and AI behaviour through the admin panel.
 
 Upload your documents, configure your contexts, and your users get an intelligent assistant that understands your content. Customer support teams, educational institutions, and enterprise organizations use Sophia to make their knowledge instantly accessible.
 

docs/cloud/sophia/mcp.adoc

@@ -38,6 +38,22 @@ These are fully functional Sophia deployments managed by SoftInstigate. You can
 
 To connect immediately with Claude Desktop, open *Settings → Connectors → Add custom connector* and paste the URL.
 
+For Claude Code, run:
+
+[source,bash]
+----
+claude mcp add --transport http sophia-restheart https://sophia-api.restheart.com/mcp/restheart
+claude mcp add --transport http sophia-cloud https://sophia-api.restheart.com/mcp/cloud
+----
+
+For private contexts, add the API token via the `--header` flag:
+
+[source,bash]
+----
+claude mcp add --transport http sophia-restheart https://<your-sophia>/mcp/<context>/ \
+  --header "Authorization: Bearer <your-token>"
+----
+
 == Clients with Streamable HTTP transport
 
 Add this to the MCP settings:
@@ -54,7 +70,7 @@ Add this to the MCP settings:
 
 == Clients with stdio transport
 
-Some clients (Claude Code, VS Code, Zed) spawn MCP servers as local processes and communicate over stdio. Use link:https://www.npmjs.com/package/mcp-remote[`mcp-remote`] as a bridge. It requires link:https://nodejs.org[Node.js >= 18] and is downloaded automatically by `npx` on first run.
+Some clients (VS Code, Zed) spawn MCP servers as local processes and communicate over stdio. Use link:https://www.npmjs.com/package/mcp-remote[`mcp-remote`] as a bridge. It requires link:https://nodejs.org[Node.js >= 18] and is downloaded automatically by `npx` on first run.
 
 Example configuration snippet:
 

docs/sophia.md

@@ -5,6 +5,36 @@ slack: false
 applies_to: both
 ---
 
+<style>
+.sophia-page-wrapper {
+  display: flex;
+  flex-direction: column;
+  height: calc(var(--vh, 1vh) * 100 - 64px);
+}
+.sophia-info-bar {
+  flex-shrink: 0;
+  border-bottom: 1px solid rgba(255, 255, 255, 0.1);
+  padding: 0.5rem 1rem;
+  font-size: 0.88rem;
+  text-align: center;
+}
+.sophia-info-bar a { color: #f8a839; }
+.sophia-page-wrapper .iframe-parent {
+  flex: 1;
+  height: auto !important;
+}
+.sophia-page-wrapper .iframe-parent iframe {
+  height: 100% !important;
+}
+</style>
+
+<div class="sophia-page-wrapper">
+<div class="sophia-info-bar">
+  You are chatting with a <strong>Sophia</strong> instance configured to answer questions about RESTHeart.
+  Sophia is an AI platform by SoftInstigate, available as a managed cloud service or for on-premises deployment —
+  <a href="/docs/cloud/sophia/">learn more</a>.
+</div>
+
 <div class="iframe-parent m-0 p-0">
   <!-- set the --vh property to set the height of the iframe correctly on desktop and mobile screen
        also scrolls to top on viewport resize
@@ -30,5 +60,6 @@ applies_to: both
       };
     }
   </script>
-  <iframe src="https://sophia.restheart.com/contexts/restheart?mcp-link=https:%2F%2Frestheart.org%2Fdocs%2Fcloud%2Fsophia%2Fmcp" scrolling="yes"></iframe>
+  <iframe src="https://sophia.restheart.com/contexts/restheart?mcp-link=https:%2F%2Frestheart.org%2Fdocs%2Fcloud%2Fsophia%2Fmcp%23softinstigate-public-mcp-servers" scrolling="yes"></iframe>
+</div>
 </div>

index.md

@@ -41,7 +41,7 @@ excerpt: RESTHeart is a comprehensive backend framework that eliminates boilerpl
             <div class="col-md-6 d-flex">
               <div class="cta-card">
                 <a href="/docs/sophia" class="btn btn-primary font-weight-bold btn-lg text-black">
-                  <span class="cta-emoji">💬</span> Chat with Sophia AI
+                  <span class="cta-emoji">💬</span> Get AI Help
                 </a>
                 <div class="cta-description mt-4 white">
                     Get instant answers about RESTHeart • No need to read through all the docs!