# Stalite

> Stalite는 팀의 목표·Task·문서·회의와 회사 운영을 관리하는 업무 플랫폼입니다.
> MCP 서버를 제공해 ChatGPT·Claude·Claude Code·Codex 같은 AI에서 Stalite의 일을 조회하고 Task·문서를 만들거나 고칠 수 있습니다.

이 파일은 AI 에이전트용 안내입니다.
사용자가 'stalite.io 확인하고 MCP 연결해줘'처럼 요청하면 아래 내용을 따라 주세요.

## Quick facts (English)

- MCP server: `https://api.stalite.io/mcp`; `https://stalite.io` is the website, not the MCP server.
- Transport: Streamable HTTP; POST only, no sessions; GET/DELETE 405.
- Auth: OAuth 2.1 (DCR, PKCE S256, public client). Alternative for CLI clients: personal access token as `Authorization: Bearer` header. ChatGPT does not support static headers.
- Versions: `2026-07-28`, `2025-11-25`, `2025-06-18`, `2025-03-26`.
- Claude Code: `claude mcp add --transport http --scope user stalite https://api.stalite.io/mcp`
- Codex: `codex mcp add stalite --url https://api.stalite.io/mcp` then `codex mcp login stalite`.
- Gemini CLI: `gemini mcp add --transport http --scope user stalite https://api.stalite.io/mcp`
- Claude link (Add required): [Stalite](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Stalite&connectorUrl=https%3A%2F%2Fapi.stalite.io%2Fmcp).
- Agent: consent before commands; user handles OAuth; no token requests in chat; call `get_profile` after connecting.

## MCP 서버

- 운영 주소는 `https://api.stalite.io/mcp`입니다.
  `https://stalite.io`와 `https://stalite.io/mcp`는 웹사이트이며 MCP 서버가 아닙니다.
- 전송은 세션 없는 Streamable HTTP, POST 전용입니다.
  GET·DELETE는 405를 반환합니다.
- 지원 프로토콜 버전은 `2026-07-28`, `2025-11-25`, `2025-06-18`, `2025-03-26`입니다.
- 권장 인증은 OAuth 2.1이며 Dynamic Client Registration을 지원합니다.
  공개 클라이언트는 PKCE S256을 사용해야 합니다.
- 인증이 없으면 401과 `WWW-Authenticate: Bearer resource_metadata=...`를 반환해 클라이언트가 로그인을 시작합니다.
- Protected Resource Metadata: <https://api.stalite.io/.well-known/oauth-protected-resource>
- Authorization Server Metadata: <https://api.stalite.io/.well-known/oauth-authorization-server>

## 연결 전 확인

- Stalite 계정과 워크스페이스 멤버 권한, 외부 연동 애드온이 필요합니다.
- 허용 화면에서 워크스페이스·권한·반영 방식을 고릅니다.
  승인 후 반영을 선택하면 AI 제안함에서 승인해야 적용됩니다.
- 워크스페이스 정책이 승인 후 반영을 강제하면 바로 반영을 고를 수 없습니다.

## AI 에이전트 행동 지침

- 터미널 에이전트는 사용자에게 알리고 동의를 받은 뒤 아래 명령으로 서버를 추가합니다.
  설정 파일 변경 전에도 먼저 알립니다.
- OAuth 로그인과 허용은 사용자가 브라우저에서 직접 합니다.
  비밀번호를 받거나 대신 로그인하지 않습니다.
- 개인 토큰을 채팅에 붙여 넣게 하지 않습니다.
  토큰이 필요하면 사용자가 환경 변수 `STALITE_TOKEN`에 직접 넣도록 안내합니다.
- ChatGPT·claude.ai는 스스로 커넥터를 추가할 수 없으므로 단계를 안내합니다.
  Claude에는 미리 채운 링크를 제공합니다.
- 연결 후 `get_profile`을 호출해 연결된 멤버와 워크스페이스를 확인합니다.

## 클라이언트별 연결 방법

아래 명령과 링크는 모두 운영 주소 기준입니다.

### ChatGPT

ChatGPT 웹(Plus·Pro·Business·Enterprise·Edu)에서 사용자가 설정(Settings) → 보안 및 로그인(Security and login) → 개발자 모드(Developer mode)를 켭니다.
플러그인(Plugins)에서 + 버튼으로 앱을 만들고 MCP 서버 URL `https://api.stalite.io/mcp`와 OAuth를 설정한 뒤 Stalite 허용 화면에서 허용합니다.

- AI가 커넥터를 직접 추가할 수 없으므로 위 단계를 안내합니다.
  딥링크는 없습니다.
- 쓰기 도구 실행 전 ChatGPT가 확인을 요청합니다.
  Business·Enterprise·Edu에서는 관리자가 개발자 모드를 허용해야 할 수 있습니다.
- 도구 변경은 앱 설정에서 새로고침(Refresh)해야 반영됩니다.

### Claude (claude.ai, Claude Desktop)

[Claude에서 Stalite 추가](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Stalite&connectorUrl=https%3A%2F%2Fapi.stalite.io%2Fmcp)

링크에는 이름과 주소만 채워지며 사용자가 Add를 눌러야 추가됩니다.
직접 연결하려면 Customize → Connectors → Add custom connector에서 `https://api.stalite.io/mcp`를 입력하고 Add → Connect를 선택합니다.

Team·Enterprise에서는 Owner가 Organization settings → Connectors → Add → Custom에서 추가합니다.
조직 관리자용 링크:

[조직 관리자용 Claude 추가 링크](https://claude.ai/admin-settings/connectors?modal=add-custom-connector&connectorName=Stalite&connectorUrl=https%3A%2F%2Fapi.stalite.io%2Fmcp)

멤버는 Customize → Connectors에서 Connect를 선택합니다.
Free 플랜은 커스텀 커넥터 1개까지 지원합니다.

### Claude Code

OAuth 연결 명령:

```sh
claude mcp add --transport http --scope user stalite https://api.stalite.io/mcp
```

그다음 Claude Code에서 `/mcp` → `stalite` → Authenticate를 선택해 브라우저에서 로그인합니다.
서버가 보이지 않으면 Claude Code를 재시작합니다.

### Codex

CLI에서 추가하고 브라우저 로그인을 진행합니다.

```sh
codex mcp add stalite --url https://api.stalite.io/mcp
codex mcp login stalite
```

`~/.codex/config.toml` 설정 방식:

```toml
[mcp_servers.stalite]
url = "https://api.stalite.io/mcp"
```

### Cursor

설치 딥링크:

```text
cursor://anysphere.cursor-deeplink/mcp/install?name=stalite&config=eyJ1cmwiOiJodHRwczovL2FwaS5zdGFsaXRlLmlvL21jcCJ9
```

또는 `~/.cursor/mcp.json`에 다음을 설정합니다.

```json
{"mcpServers":{"stalite":{"url":"https://api.stalite.io/mcp"}}}
```

설치 후 Cursor 설정의 MCP 항목에서 stalite 로그인을 진행합니다.

### VS Code

GitHub Copilot 에이전트 모드 설치 딥링크:

```text
vscode:mcp/install?%7B%22name%22%3A%22stalite%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fapi.stalite.io%2Fmcp%22%7D
```

CLI:

```sh
code --add-mcp '{"name":"stalite","type":"http","url":"https://api.stalite.io/mcp"}'
```

`.vscode/mcp.json` 설정 방식:

```json
{"servers":{"stalite":{"type":"http","url":"https://api.stalite.io/mcp"}}}
```

Copilot Business·Enterprise는 조직 정책에서 MCP 사용이 허용되어야 합니다.

### Gemini CLI

```sh
gemini mcp add --transport http --scope user stalite https://api.stalite.io/mcp
```

그다음 Gemini CLI에서 `/mcp auth stalite`를 실행합니다.

### 그 밖의 MCP 클라이언트

Streamable HTTP와 OAuth를 지원하는 클라이언트에는 `https://api.stalite.io/mcp`를 입력합니다.
OAuth가 없는 클라이언트는 Authorization 헤더에 개인 토큰을 Bearer 토큰으로 설정할 수 있습니다.

## 개인 토큰(PAT)으로 연결

- 개인 토큰은 워크스페이스 → 연동 → "AI·웹훅 연결"에서 모든 멤버가 발급할 수 있습니다.
- 권한·승인 모드·만료(30/90/180/365일)를 고릅니다.
  접두사는 `rmpat_`이며 원문은 발급 직후 한 번만 보입니다.
- 토큰은 채팅에 붙여 넣지 마세요.
  사용자가 터미널에서 환경 변수에 직접 입력합니다.

```sh
export STALITE_TOKEN='<발급한 토큰>'
claude mcp add --transport http --scope user stalite https://api.stalite.io/mcp --header "Authorization: Bearer $STALITE_TOKEN"
```

Codex CLI:

```sh
codex mcp add stalite --url https://api.stalite.io/mcp --bearer-token-env-var STALITE_TOKEN
```

ChatGPT는 고정 Authorization 헤더를 지원하지 않습니다.
claude.ai·Claude Desktop은 OAuth로 연결합니다.

## 연결하면 할 수 있는 일

- 읽기: `get_profile`, `list_spaces`, `list_members`, `list_tasks`, `get_task`, `list_documents`, `get_document`, `list_goals`, `get_goal`, `list_meetings`, `get_meeting`, `get_proposal`
- 쓰기: `create_task`, `update_task`, `set_task_status`, `create_document`, `update_document`
- 권한(scope): `tasks:read`(Task 읽기), `tasks:write`(Task 만들기·고치기), `documents:read`(문서 읽기), `documents:write`(문서 만들기·고치기), `goals:read`(목표 읽기), `meetings:read`(회의 요약 읽기)
- 삭제·보관·댓글은 어떤 모드에서도 할 수 없습니다.
- 승인 후 반영을 선택하면 외부 AI가 만든 변경은 AI 제안함에서 승인해야 반영됩니다.
  `get_proposal`로 상태를 확인할 수 있습니다.

## 문제 해결

- 허용 화면에 "선택 가능한 워크스페이스가 없습니다"가 나오면 외부 연동 애드온을 확인해 주세요.
  애드온이 없으면 도구에서 `feature_not_available` 오류가 납니다.
- `insufficient_scope` 오류가 나면 필요한 권한을 허용한 뒤 다시 연결해 주세요.
- 바로 반영을 고를 수 없다면 워크스페이스 정책이 승인 후 반영을 강제하는 경우입니다.
- 도구 목록이 바뀌지 않으면 연결을 새로고침하거나 다시 연결해 주세요.
  ChatGPT는 앱 설정에서 새로고침(Refresh)합니다.
- `stalite.io` 또는 `stalite.io/mcp`는 서버 주소가 아니므로 405 또는 연결 실패가 날 수 있습니다.
  `https://api.stalite.io/mcp`를 사용해 주세요.

## 링크

- [Stalite 홈](https://stalite.io/): 제품 안내
- [외부 AI 연결 가이드](https://stalite.io/integrations/mcp): 사람용 안내
- [AI 초안](https://stalite.io/ai): AI 소개
- 문의: [contact@kodebrg.com](mailto:contact@kodebrg.com)