AI 어시스턴트 연결(MCP)

​

필요한 것

​

브라우저 권한 부여로 연결

​

연결로 할 수 있는 일

• 선택한 회사에서 사용자 본인으로서, 현재 권한과 정확히 같은 범위로 작동합니다. 권한이 바뀌면 어시스턴트의 권한도 함께 바뀝니다.
• 해당 회사의 활성 구성원이 아니게 되면 작동을 멈춥니다.
• 회사와 사용자는 항상 연결 자체에서 결정됩니다. 어시스턴트가 다른 인수를 전달해 회사를 바꾸거나 다른 사람으로 행동할 수 없습니다.

​

로그인의 내부 동작 방식

• 그랜트 유형: authorization_code와 refresh_token. 응답 유형: code.
• S256 PKCE. 공개 클라이언트(토큰 엔드포인트 인증 방식 none)는 코드 챌린지를 보내야 합니다.
• 토큰 엔드포인트의 클라이언트 인증: client_secret_post 또는 none.
• 범위: mcp:tools.
• 인증 코드는 10분간 유효하며 한 번만 사용할 수 있습니다. 액세스 토큰은 1시간 동안 유효하며(expires_in: 3600), 클라이언트가 리프레시 토큰으로 갱신합니다.

​

API 키로 연결

Authorization: Bearer alf_your_key_here

​

클라이언트 구성

claude mcp add --transport http alforse \
  https://app.alforse.com/api/mcp \
  --header "Authorization: Bearer alf_your_key_here"

{
  "mcpServers": {
    "alforse": {
      "url": "https://app.alforse.com/api/mcp",
      "headers": { "Authorization": "Bearer alf_your_key_here" }
    }
  }
}

{
  "inputs": [
    { "id": "alforse-key", "type": "promptString", "description": "Alforse API key", "password": true }
  ],
  "servers": {
    "alforse": {
      "type": "http",
      "url": "https://app.alforse.com/api/mcp",
      "headers": { "Authorization": "Bearer ${input:alforse-key}" }
    }
  }
}

​

어시스턴트가 보는 도구

• 모든 호출은 앱과 동일한 권한 확인을 거치며, 쓰기는 동일한 서비스 계층에서 검증됩니다.
• 각 작업에는 위험 등급이 있어, 어시스턴트가 WRITE 또는 DESTRUCTIVE 작업을 실행하기 전에 사용자에게 확인할 수 있습니다.
• 목록 조회는 기본적으로 25행을 반환합니다. 어시스턴트는 limit(1–100)과 offset으로 페이지를 넘깁니다.
• 어시스턴트는 회사 시간대 기준의 오늘 날짜를 전달받으므로 “지난주” 같은 상대적 날짜가 올바르게 해석됩니다.

​

제한

​

문제 해결

​

관련 문서