https://docs.nocfoundry.dev/dev/getting-started/Recent content in Getting Started on NOCFoundry DocsHugoenhttps://docs.nocfoundry.dev/dev/getting-started/local-quickstart/Mon, 01 Jan 0001 00:00:00 +0000https://docs.nocfoundry.dev/dev/getting-started/local-quickstart/<h1 id="local-quickstart">Local Quickstart</h1> <p>This quickstart gets a local NOCFoundry instance running with the validation demo and UI.</p> <h2 id="prerequisites">Prerequisites</h2> <ul> <li>Go 1.25 or later</li> <li>Docker if you want the local Keycloak flow</li> <li>a shell with access to this repository</li> </ul> <h2 id="optional-start-the-local-sr-linux-topology">Optional: start the local SR Linux topology</h2> <p>If you want to test against a realistic network fabric instead of static examples, use the containerlab topology in <code>examples/containerlab/</code>.</p> <p>Install containerlab only when you need it:</p>https://docs.nocfoundry.dev/dev/getting-started/mcp-client-quickstart/Mon, 01 Jan 0001 00:00:00 +0000https://docs.nocfoundry.dev/dev/getting-started/mcp-client-quickstart/<h1 id="mcp-client-quickstart">MCP Client Quickstart</h1> <p>NOCFoundry exposes the Model Context Protocol at:</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-text" data-lang="text"><span class="line"><span class="cl">http://127.0.0.1:5000/mcp </span></span></code></pre></div><p>With the protected validation example, <code>/mcp</code> is protected by OIDC endpoint auth.</p> <h2 id="what-clients-need">What clients need</h2> <ul> <li>the MCP endpoint URL</li> <li>an access token whose <code>aud</code> matches the configured <code>/mcp</code> audience</li> <li>support for bearer tokens on HTTP-based MCP transports</li> </ul> <p>The protected resource metadata is served from:</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-text" data-lang="text"><span class="line"><span class="cl">/.well-known/oauth-protected-resource/mcp </span></span></code></pre></div><h2 id="minimal-connection-model">Minimal connection model</h2> <ol> <li>Start NOCFoundry with <code>examples/tools-configs/keycloak-protected-validation.yaml</code> and <code>examples/server-configs/protected-api-mcp-ui.yaml</code>.</li> <li>Obtain an access token from Keycloak.</li> <li>Configure your MCP client to connect to <code>http://127.0.0.1:5000/mcp</code>.</li> <li>Supply <code>Authorization: Bearer &lt;token&gt;</code> on every HTTP request.</li> </ol> <h2 id="audience-reminder">Audience reminder</h2> <p>The access token must match the <code>/mcp</code> audience configured in:</p>