Claude Code

Claude Code is the recommended way to use this server. You can register it with a single claude mcp add command, using either transport described in the overview.

Option A — Local (stdio), recommended

Run this from any project where you want the docs available, pointing at this project's artisan binary (use its absolute path so it works regardless of the current directory):

claude mcp add oi-docs -- php /absolute/path/to/OiDevDocs/artisan mcp:start documentation

By default the server is added to your current project scope. Add --scope user to make it available in every project:

claude mcp add --scope user oi-docs -- php /absolute/path/to/OiDevDocs/artisan mcp:start documentation

Option B — Remote (HTTP)

If the documentation site is deployed, connect over HTTP instead — no local checkout needed:

claude mcp add --transport http oi-docs https://dev.olacombe.com/mcp/documentation

Manual configuration (.mcp.json)

The commands above write to Claude Code's config. To share the server with a team via a committed .mcp.json at the project root, add it manually:

{
    "mcpServers": {
        "oi-docs": {
            "command": "php",
            "args": [
                "/absolute/path/to/OiDevDocs/artisan",
                "mcp:start",
                "documentation"
            ]
        }
    }
}

For the HTTP transport, use the type/url form instead:

{
    "mcpServers": {
        "oi-docs": {
            "type": "http",
            "url": "https://dev.olacombe.com/mcp/documentation"
        }
    }
}

Verify

List configured servers and check the connection status:

claude mcp list

Inside a Claude Code session, run /mcp to inspect the oi-docs server and its tools, then ask something like "search the OI Laravel docs for watch mode" to confirm the tools are being called.

Next steps

The MCP server gives Claude Code access to all the docs. Once you actually install a package in a project, also install its AI skill so the assistant knows that package's API in depth — see Skills & AI.