모든 MCP 클라이언트

Fóir는 호스팅 MCP 서버를 운영합니다. 여러분의 에이전트를 연결하면 연결한 사람의 권한 안에서, 또는 에이전트에 주어진 시크릿 키의 스코프 안에서 동작합니다.

호스팅 서버 하나

서버는 https://mcp.foir.dev/mcp 주소에 호스팅되며 Streamable HTTP를 사용합니다. 각 도구는 콘솔과 CLI가 사용하는 것과 같은 플랫폼 RPC를 호출하므로, 검증과 행 수준 스코핑은 플랫폼이 담당합니다. 게시가 활성화된 모델에서 레코드 쓰기는 초안 상태로 저장되며, 게시와 삭제는 별도의 도구입니다. 에이전트가 자체 모델을 가져오므로 연결해도 AI 크레딧을 소비하지 않습니다.

인증 방법 두 가지

첫 번째는 로그인입니다. 클라이언트에 서버의 URL을 추가하면 처음 사용할 때 브라우저에서 Fóir 동의 화면이 열리고, 여기서 본인의 수준까지 액세스를 허용합니다. 이후 에이전트는 여러분으로서 동작합니다.

두 번째는 시크릿 API 키이며 CI와 무인 작업에 적합합니다. foir mcp 명령은 호스팅 서버로 가는 로컬 프록시를 실행하고, 설정되어 있으면 FOIR_API_KEY 변수의 키를 사용합니다. 이때 에이전트가 닿는 범위는 키 자체의 스코프입니다. 공개 키는 거부됩니다.

로그인한 에이전트가 닿는 범위

로그인 후 에이전트의 토큰은 여러분이 액세스할 수 있는 것을 찾아볼 수만 있습니다. 하나의 워크스페이스에 들어가야 하며, 선택적으로 하나의 프로젝트와 조직에도 들어갈 수 있고, 그러면 그곳에서 여러분의 유효 권한을 가진 작업 토큰이 발급됩니다. 작업 토큰은 30분간 유효하며 다시 발급됩니다. 워크스페이스와 프로젝트는 호출마다 고를 수 없습니다.

도구 목록은 요청마다 자격 증명이 가진 것에 따라 걸러지므로, 같은 에이전트를 같은 프로젝트에 연결한 두 사람이 서로 다른 도구를 제공받을 수 있습니다.

읽기 전용 연결

동의 화면에서 읽기 전용을 선택하면 에이전트에게는 읽기 도구만 제공됩니다. 에이전트가 나중에 무엇을 읽든 동의가 상한이므로, 콘텐츠에 숨겨진 지시가 읽기 전용 권한을 쓰기로 바꿀 수 없습니다. CLI 프록시에는 로그인한 세션을 위한 같은 역할의 플래그가 있습니다. 키의 범위는 좁힐 수 없습니다.

자세한 내용

에이전트 가이드는 클라이언트별 설정, 워크스페이스와 프로젝트 선택, 에이전트가 할 수 있는 일과 할 수 없는 일을 다룹니다.