</CodeGroup>
REST API  Copy Chapter

---
Introduction  Copy Section
---
title: "Paving the road to AGI"
mode: "wide"
---
We build the worlds <br />

where intelligence learns to act <br />

one environment <br />

one trajectory <br />

one step at a time
---
Quickstart  Copy Section
---
title: Quickstart
description: Let your agent connect any tools reliably in minutes via MCP
icon: rocket
mode: "wide"
---
Strata  Copy Chapter

One MCP server that lets AI agents handle any tools progressively.
<Tabs>
  <Tab title="UI">
    <Steps>
      <Step title="Open Dashboard">
        Go to your <a href="https://www.klavis.ai/home/mcp-servers">Dashboard</a>.
        
        <Tip>
        Klavis enables all integrations for you by default. Click the ellipsis button if you want to disable a specific integration.
        </Tip>
        
        <img
          className="block dark:hidden"
          src="/images/get-started/quickstart/strata_ui.png"
          alt="Strata UI Dashboard"
        />
        <img
          className="hidden dark:block"
          src="/images/get-started/quickstart/strata_ui.png"
          alt="Strata UI Dashboard"
        />
      </Step>
      <Step title="Authenticate">
        Complete authentication by clicking the "Authorize" button. Most of the applications has OAuth support. Just follow the OAuth flow to authorize them.
        
        Some applications might need you to provide API keys or other kinds of secrets to authorize.
        Some applications don't have "Authorize" buttons. It means they don't require authentication and you can access them directly.
        <Tip>
        We also provide an authentication handler tool in MCP that will prompt to authenticate when if you didn't authorize them.
        </Tip>
        <img
          className="block dark:hidden"
          src="/images/get-started/quickstart/oauth.png"
          alt="Strata OAuth Example"
        />
        <img
          className="hidden dark:block"
          src="/images/get-started/quickstart/oauth.png"
          alt="Strata OAuth Example"
        />
      </Step>
      <Step title="Use in your app">
        Add to your favorite MCP-supported clients, such as Cursor, Claude Code, VS Code, ChatGPT, etc.
        To get the MCP server URL and access token, click the "Add to Other Clients" button on the top right corner of the dashboard.
        <Tip>
        Both the URL with access token and the direct URL provide you with the same MCP. But it's recommended to use the URL with access token as it's a more secure way to connect.
        DO NOT share your access token or direct URL publicly as they provide access to your connected accounts and data.
        </Tip>
        <img
          className="block dark:hidden"
          src="/images/get-started/quickstart/url.png"
          alt="Strata URL"
        />
        <img
          className="hidden dark:block"
          src="/images/get-started/quickstart/url.png"
          alt="Strata URL"
        />
      </Step>
    </Steps>
  </Tab>
  <Tab title="API">
    <Info>
    Prerequisites Before you begin, create an account and get the API Key.
    </Info>
    <Steps>
      <Step title="Install the SDKs">
        <CodeGroup>

</CodeGroup>
      </Step>
      <Step title="Create Strata MCP Server">
        <Tip>
        userId specifies whose connected accounts and data you are accessing in Klavis. It should be a unique id for yourself, your team, or your organization.
        </Tip>
        <CodeGroup>

</CodeGroup>
        <Info>
        Response Information: The API returns:
        - strataServerUrl: The URL you'll use to connect your MCP client to the Strata MCP Server
        - oauthUrls: Authorization links for services that require OAuth authentication
        - apiKeyUrls: Links to configure API keys for services that use API key authentication
        </Info>
        <Card title="API Reference" icon="magnifying-glass" href="/api-reference/strata/create" horizontal>
          Full Strata API endpoints
        </Card>
      </Step>
      <Step title="Authenticate required apps">
        <CodeGroup>

</CodeGroup>
        
        <Info>
        Authentication Methods:
        - API Key: See API Key authentication guide for details.
        - OAuth: See OAuth authentication guide for details.
        </Info>
        
        <Check>
        🎉 Your MCP Server URL is ready to use! Once authentication is complete, you can use your MCP server URL with any MCP-compatible client.
        </Check>
      </Step>
      <Step title="(Optional) Connect to your AI application">
        <Tabs>
          <Tab title="LangChain">
            <CodeGroup>

</CodeGroup>
          </Tab>
          <Tab title="LlamaIndex">
           <CodeGroup>

</CodeGroup>
          </Tab>
          <Tab title="CrewAI">
            <Info>Coming soon</Info>
          </Tab>
          <Tab title="AutoGen">
            <CodeGroup>

</CodeGroup>
          </Tab>
        </Tabs>
      </Step>
    </Steps>
  </Tab>
  <Tab title="Open Source">
    <Tip>
    Visit https://github.com/Klavis-AI/klavis to view the source code and find more information
    </Tip>
    <Steps>
      <Step title="Install Strata MCP">
        <CodeGroup>

</CodeGroup>
      </Step>
      <Step title="Add your MCP servers">
        Configure your MCP servers using the CLI tool.
        <CodeGroup>

</CodeGroup>
      </Step>
      <Step title="Run Strata MCP Server">
        Start the Strata server to manage all your tools.
        <CodeGroup>

</CodeGroup>
      </Step>
      <Step title="Connect to your AI application">
        Use the Strata tool to add your AI client.
        <CodeGroup>

</CodeGroup>
      </Step>
    </Steps>
  </Tab>
</Tabs>
<Info>
  If you're interested in 1:1 mapping between API and tool using our MCP Server Instance, check here.
</Info>
Next steps  Copy Chapter
<CardGroup cols={2}>
  <Card title="AI Platform Integrations" icon="handshake" href="/ai-platform-integration/overview">
    Integrate Klavis MCP Servers with leading AI platforms
  </Card>
  <Card title="Integrations" icon="server" href="/mcp-server/github">
    Explore available MCP servers
  </Card>
  <Card title="Strata" icon="layer-group" href="/concepts/strata">
    Progressive tool discovery across apps
  </Card>
  <Card title="API Reference" icon="magnifying-glass" href="/api-reference/introduction">
    REST endpoints and schemas
  </Card>
</CardGroup>
---
CONTRIBUTING  Copy Section
Contributing to Klavis AI
Thank you for your interest in contributing to Klavis AI! This document outlines the process and conventions we use for contributions, pull requests, and commit messages.
Contributor License Agreement (CLA)  Copy Chapter
Before we can accept your contributions, we require all contributors to sign our Contributor License Agreement (CLA). This is a one-time process.
Contributor License Agreement
The CLA helps ensure that everyone who submits a contribution has the legal right to do so and agrees to the terms under which the contribution is accepted. Without this agreement, we cannot review or accept your contributions.
Table of Contents  Copy Chapter
- Contributor License Agreement (CLA)
- Code of Conduct
- Getting Started
- Development Workflow
- Commit Message Convention
- Pull Request Process
- Code Style Guidelines
- Testing Guidelines
- License
Code of Conduct  Copy Chapter
We expect all contributors to follow our Code of Conduct. Please be respectful and inclusive in all interactions.
Getting Started  Copy Chapter
1. Fork the repository
2. Clone your fork: git clone https://github.com/yourusername/klavisAi.git
3. Add the upstream remote: git remote add upstream https://github.com/Klavis-AI/klavis.git
4. Create a new branch for your feature or bug fix
5. Make your changes
6. Submit a pull request
Development Workflow  Copy Chapter
Monorepo Structure  Copy Section
The project is organized as a monorepo with multiple MCP servers and clients:
- mcp_servers/ - Contains individual Model Context Protocol servers
- mcp_clients/ - Contains clients that connect to MCP servers
When making changes, be mindful of the scope of your change and any potential impacts on other components.
Building MCP Servers  Copy Section
If you're interested in contributing a new MCP server to the project, we have a comprehensive guide to help you get started:
📖 MCP Server Guide - A complete guide covering:
- What MCP servers are and how they work
- How to design effective tools for AI agents
- Development best practices and testing requirements
- Step-by-step instructions with examples
This guide is essential reading for anyone wanting to build high-quality MCP servers that integrate well with AI applications.
Commit Message Convention  Copy Chapter
We follow a simplified version of the Conventional Commits specification for commit messages.
Format:

Type  Copy Section
Must be one of the following:
- feat: A new feature
- fix: A bug fix
- docs: Documentation only changes
- style: Changes that do not affect the meaning of the code (formatting, etc.)
- refactor: A code change that neither fixes a bug nor adds a feature
- perf: A code change that improves performance
- test: Adding missing or correcting existing tests
- chore: Changes to the build process or auxiliary tools
- ci: Changes to CI configuration files and scripts
Scope  Copy Section
The scope is optional and can be anything specifying the place of the commit change. For example: slack, github, supabase, etc.
Subject  Copy Section
The subject contains a succinct description of the change:
- Use the imperative, present tense: "change" not "changed" nor "changes"
- Don't capitalize the first letter
- No period (.) at the end
Examples  Copy Section

Pull Request Process  Copy Chapter
1. Create a descriptive PR title following the commit message format: