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

# Laravel과 AI 개발

> Laravel은 AI 지원 개발에 최적화된 프레임워크입니다. Laravel Boost에 의한 MCP 서버 연동, AI 가이드라인, 문서 검색 API를 활용해 AI 코딩 에이전트의 능력을 최대한으로 이끌어냅시다.

## Laravel이 AI 개발에 적합한 이유

[Claude Code](https://docs.anthropic.com/en/docs/claude-code), [Cursor](https://cursor.com), [GitHub Copilot](https://github.com/features/copilot) 같은 AI 코딩 에이전트는 코드 생성·디버깅·리팩터링을 극적으로 가속화합니다. 그러나 에이전트의 능력을 최대한 발휘하려면 코드베이스를 에이전트가 정확하게 이해할 수 있어야 합니다.

Laravel은 이 점에서 다른 프레임워크보다 우위에 있습니다. 규약에 기반한 설계이기 때문에 "컨트롤러를 추가해줘"라고 부탁하면 에이전트는 배치 장소를 파악하고 있습니다. "마이그레이션을 만들어줘"라고 부탁하면 명명 규칙도 파일 위치도 예측할 수 있습니다. 이 일관성이 AI 도구를 헷갈리게 하는 "모호함"을 제거합니다.

Eloquent의 관계, 폼 리퀘스트, 미들웨어 같은 기능은 에이전트가 확실히 이해하고 재현할 수 있는 패턴을 따르고 있습니다. 결과적으로 생성되는 코드는 범용적인 PHP 스니펫의 짜깁기가 아니라, 숙련된 Laravel 개발자가 작성한 것 같은 관용적인 코드가 됩니다.

## Laravel Boost

[Laravel Boost](https://github.com/laravel/boost)는 AI 코딩 에이전트와 Laravel 애플리케이션의 다리 역할을 하는 패키지입니다. Boost는 **MCP(Model Context Protocol) 서버**로 동작하며, 15개 이상의 전용 도구를 통해 에이전트에게 애플리케이션의 구조·데이터베이스·라우트 등을 깊이 이해시킵니다.

Boost가 제공하는 주요 기능은 세 가지입니다.

<Columns>
  <Card title="MCP 도구군" icon="wrench">
    애플리케이션 검사·조작에 사용할 수 있는 15개 이상의 도구. 데이터베이스 스키마 확인부터 Artisan 명령 실행까지 대응.
  </Card>

  <Card title="AI 가이드라인" icon="book-open">
    Laravel 에코시스템을 위해 설계된 AI 가이드라인. 관용적인 코드를 작성하기 위한 베스트 프랙티스를 에이전트에게 전달.
  </Card>

  <Card title="문서 검색 API" icon="magnifying-glass">
    17,000건 이상의 Laravel 고유 문서를 검색. 설치된 패키지 버전에 맞는 정확한 정보를 제공.
  </Card>
</Columns>

### 설치

Boost는 Laravel 10, 11, 12, 13과 PHP 8.1 이상에서 동작합니다. 우선 개발 의존성으로 추가합시다.

<Steps>
  <Step title="패키지를 설치한다">
    ```shell theme={null}
    composer require laravel/boost --dev
    ```
  </Step>

  <Step title="인터랙티브 인스톨러를 실행한다">
    ```shell theme={null}
    php artisan boost:install
    ```

    인스톨러가 IDE와 AI 에이전트를 자동 검출합니다. 사용할 통합을 선택하면 MCP 서버용 `.mcp.json`이나 가이드라인 파일 등 필요한 설정 파일이 생성됩니다.
  </Step>
</Steps>

<Info>
  `.mcp.json`, `CLAUDE.md`, `boost.json` 등의 생성 파일은 개발자마다 환경을 설정하고 싶은 경우 `.gitignore`에 추가해도 문제없습니다.
</Info>

### 사용 가능한 MCP 도구

Boost가 에이전트에게 공개하는 도구에는 다음과 같은 것들이 있습니다.

| 도구         | 설명                                                    |
| ---------- | ----------------------------------------------------- |
| 애플리케이션 검사  | PHP와 Laravel의 버전, 설치된 패키지, 설정·환경 변수를 확인               |
| 데이터베이스 도구  | 스키마 확인, 읽기 전용 쿼리 실행, 데이터 구조 파악                        |
| 라우트 검사     | 미들웨어·컨트롤러·파라미터를 포함한 모든 등록 라우트를 목록 표시                  |
| Artisan 명령 | 사용 가능한 Artisan 명령과 인수를 탐색. 적절한 명령을 에이전트가 제안·실행        |
| 로그 해석      | 애플리케이션 로그 파일의 읽기와 해석으로 디버깅을 지원                        |
| 브라우저 로그    | Laravel의 프런트엔드 도구 사용 시의 브라우저 콘솔 로그와 에러에 접근            |
| Tinker 통합  | Laravel Tinker를 경유해 애플리케이션 컨텍스트 내의 PHP 코드를 실행해 동작을 검증 |
| 문서 검색      | 설치된 패키지 버전에 대응한 Laravel 에코시스템의 문서를 검색                 |

### AI 가이드라인

Boost의 AI 가이드라인은 Laravel 에코시스템을 위해 설계된 코딩 규약집입니다. 관용적인 Laravel 코드 작성법, 프레임워크 규약, 자주 있는 함정을 피하는 방법을 에이전트에게 전달합니다. 가이드라인은 설치된 패키지 버전에 따라 자동으로 조합됩니다.

대응 패키지 예시:

* Livewire(2.x, 3.x, 4.x)
* Inertia.js(React, Svelte, Vue 변형)
* Tailwind CSS(3.x, 4.x)
* Filament(3.x, 4.x)
* PHPUnit·Pest PHP·Laravel Pint 등

`boost:install`을 실행하면 `composer.json`에 기반해 사용 중인 패키지를 자동 검출하고, 관련 가이드라인을 AI 컨텍스트 파일에 통합합니다.

### Agent Skills

[Agent Skills](https://agentskills.io/home)는 에이전트가 필요할 때 온디맨드로 읽어 들이는 경량 지식 모듈입니다. 가이드라인과 달리 처음부터 모두 읽어 들이는 것이 아니라, 특정 도메인에서 작업할 때만 관련 스킬을 활성화합니다. 이를 통해 컨텍스트의 비대화를 방지하고, 생성 코드의 정확도를 높입니다.

Livewire, Inertia, Tailwind CSS, Pest 같은 인기 패키지용 스킬이 준비되어 있습니다. `boost:install`에서 스킬 기능을 선택하면 `composer.json`의 내용에 기반해 자동으로 설치됩니다.

### 문서 검색 API

Boost의 문서 API는 17,000건 이상의 Laravel 에코시스템 문서를 에이전트가 검색할 수 있게 해 줍니다. 일반적인 웹 검색과 달리 설치된 패키지 버전에 맞춰 인덱스화·벡터화되어 있습니다.

에이전트가 어떤 기능의 동작을 조사하고 싶을 때, 이 API를 사용해 버전 고유의 정확한 정보를 얻을 수 있습니다. 오래된 프레임워크 버전의 지원 중단 메서드나 문법을 에이전트가 제안해 버리는 문제를 해소합니다.

### 대응 에이전트

Boost는 Model Context Protocol을 지원하는 주요 IDE와 AI 도구에 대응합니다.

<Columns>
  <Card title="Cursor" icon="arrow-pointer" href="https://cursor.com" />

  <Card title="Claude Code" icon="terminal" href="https://docs.anthropic.com/en/docs/claude-code" />

  <Card title="GitHub Copilot" icon="github" href="https://github.com/features/copilot" />

  <Card title="Gemini CLI" icon="arrow-right" href="https://github.com/google-gemini/gemini-cli" />

  <Card title="Codex" icon="arrow-right" href="https://openai.com/codex" />

  <Card title="Junie" icon="arrow-right" href="https://www.jetbrains.com/junie/" />
</Columns>

각 에이전트의 자세한 세팅 순서는 [Boost 문서의 "Set Up Your Agents" 섹션](https://laravel.com/docs/boost#set-up-your-agents)을 참조해 주세요.

## 다음 단계

<Card title="Laravel Boost 공식 문서" icon="book-open-cover" href="https://laravel.com/docs/boost">
  각 에이전트와의 자세한 연동 방법, MCP 도구의 레퍼런스, 가이드라인 커스터마이징에 대해서는 공식 문서를 참조해 주세요.
</Card>


## Related topics

- [Laravel AI SDK](/ko/ai-sdk.md)
- [Laravel MCP](/ko/mcp.md)
- [Laravel에서 MCP 서버 만들기](/ko/advanced/mcp-server.md)
- [Laravel 패키지 개발](/ko/advanced/package-development.md)
- [Laravel Boost](/ko/boost.md)