diff --git a/README.md b/README.md
index 015b3b4d9..dea1a0f78 100644
--- a/README.md
+++ b/README.md
@@ -57,7 +57,7 @@
 [![BrowserOS agent in action](docs/videos/browserOS-agent-in-action.gif)](https://www.youtube.com/watch?v=SoSFev5R5dI)
 <br/><br/>
 
-### 🎇 Install [BrowserOS as MCP](https://docs.browseros.com/browseros-mcp/how-to-guide) and control it from `claude-code`
+### 🎇 Install [BrowserOS as MCP](https://docs.browseros.com/features/use-with-claude-code) and control it from `claude-code`
 
 https://github.com/user-attachments/assets/c725d6df-1a0d-40eb-a125-ea009bf664dc
 
diff --git a/docs/index.mdx b/docs/index.mdx
index e2eb78b7f..a030e16df 100644
--- a/docs/index.mdx
+++ b/docs/index.mdx
@@ -37,7 +37,7 @@ BrowserOS is an AI-native browser that lets you automate any web task by describ
   <Step title="Configure your AI">
     BrowserOS includes a default AI model with limited daily usage for testing. For the full experience, bring your own API keys.
 
-    <Card title="Set up your LLM provider" icon="key" href="/llm-setup-guide">
+    <Card title="Set up your LLM provider" icon="key" href="/features/bring-your-own-llm">
       Configure Gemini, Claude, OpenAI, or run models locally with Ollama
     </Card>
   </Step>