Install Valla Index

AI Quick Start

OpenAI CodexClaude CodeCursor

Use the public Cloudflare MCP endpoint when you want an agent to use this knowledge base without Git credentials or a local clone.

https://valla-index.pages.dev/mcp

Codex

Add the hosted MCP server:

codex mcp add valla-index --url https://valla-index.pages.dev/mcp

Restart Codex Desktop or open a new thread, then run /mcp to confirm valla-index is connected.

Claude Code

Add the hosted MCP server:

claude mcp add --transport http valla-index https://valla-index.pages.dev/mcp

Restart Claude Code or open a new session. The tools should appear as:

Microsoft Teams and Copilot

Use the same public MCP endpoint for Microsoft 365 Copilot and Teams agent experiments:

https://valla-index.pages.dev/mcp

Fastest Copilot Studio path:

1. Open the target agent in Copilot Studio.
2. Go to Tools.
3. Select Add a tool > New tool > Model Context Protocol.
4. Enter:
   • Server name: Valla Index
   • Server description: Search Valla documentation, project evidence, delivery context, and the approved repository inventory.
   • Server URL: https://valla-index.pages.dev/mcp
   • Authentication: None
5. Create the tool, add the MCP tools to the agent, then test with: Search CDP Index for MCP setup.

Teams / Microsoft 365 Copilot agent path:

1. Use Microsoft 365 Agents Toolkit in VS Code.

2. Create a new declarative agent.

3. Add an action and choose Start with an MCP server.

4. Enter https://valla-index.pages.dev/mcp.

5. Select the tools to expose, usually:

6. Test locally through Microsoft 365 Copilot, then package and publish the agent to Teams/Microsoft 365 through the tenant approval flow.

Do not use undefined for Copilot or Teams unless the Microsoft connector is configured with Cloudflare Access service-token headers. Without that, Microsoft clients receive the Cloudflare Access login redirect instead of MCP JSON-RPC.

Local Repository Setup

Use these links only when you want to open the Git-backed repository in an agent and configure the local MCP server from mcp/.

• Open in Codex: uses Codex originUrl matching to find a local workspace with the https://github.com/bakerstreetco/valla-index remote.
• Open in Claude Code: uses Claude Code cwd matching for this local clone. Claude Code's repo= deeplink is GitHub owner/name based, so use cwd= for non-GitHub repositories.

If the clone is not present locally:

git clone https://github.com/bakerstreetco/valla-index.git valla-index && cd valla-index && npm install && npm run mcp:build

Configure the local stdio MCP server:

claude mcp add --transport stdio valla-index -- sh -lc 'cd valla-index/mcp && node dist/src/server.js'
codex mcp add valla-index -- sh -lc 'cd valla-index/mcp && node dist/src/server.js'

Sources checked: Claude Code deep links, Claude Code MCP, Codex app deep links, Codex MCP, Cursor deep links, Cursor MCP, Copilot Studio MCP onboarding, Microsoft 365 agent connectors for MCP.