# Docs Home

> For AI agents: the complete documentation index is available at https://reshapr.io/llms.txt and the full documentation bundle at https://reshapr.io/llms-full.txt.

> Welcome to reShapr documentation — guides, tutorials, and reference for no-code MCP servers and AI-native API access.

# Welcome to reShapr docs

Choose the path that matches where you want to run reShapr. Each path starts with an existing environment, states the result you can reach now, and points to the next useful task.

## Choose your path

<DocCardList
  items={[
    {
      type: 'link',
      label: 'Try online',
      href: '/docs/tutorials/try-reshapr-online',
      docId: 'tutorials/try-reshapr-online',
      description:
        'Start in the hosted environment. Result: create an MCP endpoint and call a live weather Tool.',
    },
    {
      type: 'link',
      label: 'Develop locally',
      href: '/docs/how-to-guides/docker-compose',
      docId: 'how-to-guides/docker-compose',
      description:
        'Start reShapr with Docker or Podman. Result: create an MCP endpoint and call a Tool through your local Gateway.',
    },
    {
      type: 'link',
      label: 'Deploy and operate on Kubernetes',
      href: '/docs/tutorials/first-gitops-mcp-endpoint',
      docId: 'tutorials/first-gitops-mcp-endpoint',
      description:
        'Install the controllers and reconcile an MCP endpoint from Git-managed Kubernetes resources.',
    },
  ]}
/>

## Design the right interface

<DocCardList
  items={[
    {
      type: 'link',
      label: 'Control context',
      href: '/docs/references/spec-outtools-filtering',
      docId: 'references/spec-outtools-filtering',
      description:
        'Retain, patch, or convert tool outputs before they reach the model.',
    },
    {
      type: 'link',
      label: 'Review security controls',
      href: '/docs/explanations/security-model',
      docId: 'explanations/security-model',
      description:
        'Understand endpoint authentication, backend credentials, trust boundaries, and current limits.',
    },
    {
      type: 'link',
      label: 'Find a product interface',
      href: '/docs/references/interfaces',
      docId: 'references/interfaces',
      description:
        'Open the canonical API, CLI, Kubernetes, or Helm contract without relying on copied details.',
    },
  ]}
/>
