> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agi.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Guides

> Concepts, workflows, and best practices for AGI Agentic Phone MCP.

## Getting Started

New to AGI Agentic Phone MCP? Start here:

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/api-reference/quickstart">
    Connect a client and run your first phone task
  </Card>

  <Card title="Connect your AI client" icon="plug" href="/android-mcp/connect">
    Claude Code, Claude Desktop, Cursor, ChatGPT, IDE extensions
  </Card>

  <Card title="Architecture" icon="diagram-project" href="/guides/concepts/architecture">
    How client, cloud, and phone fit together
  </Card>

  <Card title="Task Lifecycle" icon="arrows-spin" href="/guides/concepts/task-lifecycle">
    States, terminal outcomes, and the monitor loop
  </Card>
</CardGroup>

***

## Core Concepts

<CardGroup cols={2}>
  <Card title="Architecture" icon="diagram-project" href="/guides/concepts/architecture">
    The three-piece system and the async execution model
  </Card>

  <Card title="Devices & Sessions" icon="mobile" href="/guides/concepts/devices-and-sessions">
    Devices, the default device, sessions, and the execution lane
  </Card>

  <Card title="Task Lifecycle" icon="arrows-spin" href="/guides/concepts/task-lifecycle">
    Four states, nine terminal outcomes, human-in-the-loop handoffs
  </Card>
</CardGroup>

***

## Use Cases & Examples

Real workflows you can run today:

<CardGroup cols={2}>
  <Card title="Messaging" icon="message" href="/guides/use-cases/messaging">
    Send messages with confirmation gates
  </Card>

  <Card title="Daily Assistant" icon="sun" href="/guides/use-cases/daily-assistant">
    Calendar, inbox, and multi-app catch-ups
  </Card>

  <Card title="Cross-App Workflows" icon="arrows-turn-to-dots" href="/guides/use-cases/cross-app-workflows">
    Multi-task workflows in one session
  </Card>

  <Card title="App Testing & QA" icon="vial" href="/guides/use-cases/app-testing">
    Real-device app walkthroughs and bug reports
  </Card>
</CardGroup>

***

## Best Practices

<CardGroup cols={2}>
  <Card title="Task Design" icon="pen-to-square" href="/guides/best-practices/task-design">
    Write prompts that phone agents execute reliably
  </Card>

  <Card title="Session Management" icon="window-restore" href="/guides/best-practices/session-management">
    Sessions, devices, and workflow boundaries
  </Card>

  <Card title="Error Handling" icon="shield-halved" href="/guides/best-practices/error-handling">
    Handle every terminal outcome deliberately
  </Card>

  <Card title="Performance" icon="bolt" href="/guides/best-practices/performance">
    Timeouts, queue waits, and task sizing
  </Card>

  <Card title="Security" icon="lock" href="/guides/best-practices/security">
    The trust model and how to stay inside it
  </Card>

  <Card title="Monitoring" icon="chart-line" href="/guides/best-practices/monitoring">
    Steps, snapshots, and debugging live tasks
  </Card>
</CardGroup>

***

## Troubleshooting

<CardGroup cols={2}>
  <Card title="Troubleshooting Guide" icon="wrench" href="/guides/troubleshooting">
    Start here: symptom-based index
  </Card>

  <Card title="Devices & Connectivity" icon="mobile" href="/guides/troubleshooting/devices">
    Missing devices, offline devices, empty tool lists
  </Card>

  <Card title="Tasks & Sessions" icon="list-check" href="/guides/troubleshooting/tasks">
    Stuck, paused, pending, and cancelled tasks
  </Card>

  <Card title="Authentication" icon="key" href="/guides/troubleshooting/authentication">
    OAuth and API key failures
  </Card>

  <Card title="MCP Clients" icon="plug" href="/guides/troubleshooting/mcp-clients">
    Connection, transport, and client-specific issues
  </Card>
</CardGroup>

***

## Quick Reference

<CardGroup cols={3}>
  <Card title="Tool Reference" icon="code" href="/api-reference/introduction">
    Every tool, parameter, and outcome
  </Card>

  <Card title="Agentic Phone MCP Setup" icon="android" href="/android-mcp">
    Server details and client setup
  </Card>

  <Card title="Support" icon="headset" href="mailto:support@theagi.company">
    Get help from our team
  </Card>
</CardGroup>