개발자를 위한 yarnnn

하나의 워크스페이스, 회원님이 쓰는 모든 AI

yarnnn은 Model Context Protocol 서버예요. MCP를 쓰는 어시스턴트를 다음 주소로 연결하면 mcp.yarnnn.com 사람이 보는 것과 같은 파일을 읽고 써요. 별도의 메모리 저장소도, 동기화 단계도 없어요.

모든 쓰기에는 그것을 만든 클라이언트의 이름이 남고, 되짚어 갈 수 있는 수정본 사슬에 쌓여요. 연결은 사용자인 척하는 키가 아니라 원장에서 자기 이름으로 행동해요. 그래서 “이거 누가 바꿨지?” 라는 질문에, 답이 다른 AI일 때조차 진짜 답이 있어요. 단순 저장 연결로는 할 수 없는 일이고요.

인증은 동적 클라이언트 등록을 지원하는 OAuth 2.1이고, 접근 권한은 동사 단위로 나뉘어요. 아래 모든 것이 예측 가능한 URL에 있어요.

개발자 리소스

MCP 커넥터

↗︎

Model Context Protocol 서버예요. ChatGPT, Claude를 비롯해 MCP를 쓰는 어떤 어시스턴트든 연결해서 워크스페이스의 파일을 바로 읽고 쓸 수 있어요.

Transport: streamable-http · Auth: OAuth 2.1

OpenAPI 명세

→

기계가 읽는 API 계약(OpenAPI 3.1)이에요. 에이전트가 MCP로 호출하는 파일 중심 동사들을 요청·응답 형태와 함께 설명해요.

GET /openapi.json

MCP 디스커버리 카드

→

웹사이트에서 서버로 이어지는 이정표예요. MCP 서버와 전송 방식, OAuth 메타데이터의 위치를 알려주어 에이전트가 커넥터를 스스로 찾을 수 있게 해요.

GET /.well-known/mcp.json

OAuth 2.1 인가 메타데이터

↗︎

MCP 커넥터의 인가 서버 메타데이터예요. 엔드포인트, 지원하는 grant, 스코프까지 표준 OAuth 2.1 디스커버리를 따라요.

GET /.well-known/oauth-authorization-server

llms.txt

→

언어 모델을 위한 일반 텍스트 요약이에요. 제품이 무엇인지, MCP로 어떻게 연결하는지, 주요 리소스가 어디 있는지 담고 있어요.

GET /llms.txt

제품 문서

↗︎

사람이 읽는 문서예요. 개념, 파일이 어떻게 보관되는지, 그리고 yarnnn을 제대로 쓰는 안내를 담고 있어요.

GitBook

에이전트가 호출하는 동사

파일 중심이에요. 사람이 보는 것과 같은 파일을 읽고 쓰며, 모든 쓰기에는 작성자의 이름이 남아요. 전체 내용은 여기에 문서화돼 있어요 — OpenAPI 명세.

whoami

읽기

지금 어디에 서 있는지 알려줘요. 이 연결이 어떤 워크스페이스에 묶여 있는지, 쓰기가 누구 이름으로 남을지, 토큰이 어떤 동사를 허용하는지요. 사용자가 짐작한 곳에 쓰기 전에 먼저 호출해 주세요.

open

읽기

정확히 한 파일을 읽어요. 현재 내용, 마지막으로 바꾼 사람과 시점, 최근 서명된 수정본까지요. 모르는 경로는 모른다고 말해요. open은 절대 추측하지 않아요.

list

읽기

폴더 아래 파일을 나열해요. 변경 피드를 위한 타임스탬프를 받아 마지막으로 들른 뒤 무엇이 움직였는지 알려주고, 큰 하위 트리는 페이지로 나눠 줘요.

search

읽기

의미로 파일을 찾아요. 발췌와 확신도 신호를 함께 담아 순위가 매겨진 결과를 돌려주기 때문에, 애매한 결과는 추측하지 않고 되물을 수 있어요.

history

읽기

정확히 한 파일이 시간이 지나며 어떻게 바뀌었는지 보여줘요. 각 수정본을 누가 언제 작성했고 무엇이 바뀌었는지, 이전 버전과의 차이까지요. 단순 저장 연결로는 보여줄 수 없는 기능이에요.

runs

읽기

워크스페이스의 에이전트가 한 일을 읽어요 — 실행 기록을 최신순으로요. 정기 작업의 실행이나, 멤버 자신의 브라우저에서 에이전트가 한 행동을 단계별로: 각 단계가 끝났을 때 탭이 어디에 있었는지, 무엇에 대해 행동했는지, 무엇이 바뀌었는지까지요. 모델의 설명이 아니라 실행기의 영수증이에요. 읽기 전용이고 멱등해요.

save

쓰기

파일을 서명된 수정본으로 다시 써요. 열어본 수정본을 함께 넘기면 동시에 일어난 변경을 덮어쓰지 않고 거절해요. 이전 버전은 모두 사슬에 남고요.

edit

쓰기

파일의 현재 텍스트에 정확히 기대어 일부만 바꿔요. 바뀐 부분만 오가기 때문에 읽지 않은 내용은 위험해지지 않아요. 큰 파일에 알맞은 동사예요.

delete

쓰기

살아 있는 워크스페이스에서 파일을 치워요. 잃는 것은 없어요. 사슬이 내용을 간직하고 있어서 되살릴 수 있어요.

move

쓰기

파일을 옮기거나 이름을 바꿔요. 이미 있는 목적지를 덮어쓰지 않고 거절해요. 그건 먼저 의도적으로 지워야 해요.

request_upload

쓰기

텍스트가 아니라 바이트로 도착하는 내용을 위한 짧은 수명의 URL을 받아요. 이미지, PDF, 내보낸 파일 같은 것들이요. 다른 파일과 똑같이 서명된 파일로 쌓여요.

쓰기

파일 하나 또는 워크스페이스 전체에 대한 링크를 만들어요. 전체 접근이나 읽기 전용으로요. 링크를 여는 사람은 작업물과 누가 만들었는지를 함께 봐요.

필요한 만큼만 요청하세요

접근 권한은 동사 단위로 나뉘고 호출할 때마다 확인돼요. 예를 들어 files:read 만 가진 토큰이 저장을 시도하면 거절돼요. 등급은 더해지는 방식이고, 아무것도 명시하지 않은 등록은 읽기 전용이 돼요.

files:read

파일을 읽어요 — open, list, search, 기록 보기, 그리고 에이전트가 한 일(runs)까지요.

files:write

파일을 만들고, 고치고, 옮기고, 지워요. 모든 변경에 이름이 남고 되돌릴 수 있어요.

files:share

공유 링크를 만들어요. 링크를 여는 사람에게 멤버와 같은 접근 권한을 줄 수도 있어요.

연결을 승인하는 사람도 승인 전에 똑같은 문장을 보고, 언제든 권한을 좁히거나 회수할 수 있어요.

에이전트를 yarnnn에 연결하세요

MCP를 쓰는 어시스턴트를 커넥터로 연결하고 OAuth 2.1로 인가하면 돼요. 바로 워크스페이스의 파일을 읽고 쓸 수 있고, 모든 변경이 그 연결의 이름으로 남아요.

MCP 커넥터 OpenAPI 명세 보기